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Intellectual Property Rights 

IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http ://webapp . etsi .org/IPR/home . asp ) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by Joint Technical Committee (JTC) Broadcast of the European 
Broadcasting Union (EBU), Comite Europeen de Normalisation ELECtrotechnique (CENELEC) and the European 
Telecommunications Standards Institute (ETSI). 

NOTE: The EBU/ETSI JTC Broadcast was established in 1990 to co-ordinate the drafting of standards in the 
specific field of broadcasting and related fields. Since 1995 the JTC Broadcast became a tripartite body 
by including in the Memorandum of Understanding also CENELEC, which is responsible for the 
standardization of radio and television receivers. The EBU is a professional association of broadcasting 
organizations whose work includes the co-ordination of its members' activities in the technical, legal, 
programme-making and programme-exchange domains. The EBU has active members in about 
60 countries in the European broadcasting area; its headquarters is in Geneva. 

European Broadcasting Union 
CH-1218 GRAND SACONNEX (Geneva) 
Switzerland 

Tel: +41 22 717 21 11 
Fax: +41 22 717 24 81 

Founded in September 1993, the DVB Project is a market-led consortium of public and private sector organizations in 
the television industry. Its aim is to establish the framework for the introduction of MPEG-2 based digital television 
services. Now comprising over 200 organizations from more than 25 countries around the world, DVB fosters 
market-led systems, which meet the real needs, and economic circumstances, of the consumer electronics and the 
broadcast industry. 
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1 Scope 

The present document defines the GEM platform based on MHP [1]. GEM is applicable for specifications and standards 
based on the MHP APIs, content formats, and semantic guarantees. 

The present document is firstly intended to be used by entities writing terminal specifications and/or standards based on 
MHP. Secondly it is intended for developers of applications that use the GEM functionality and APIs. The GEM 
specification aims to ensure interoperability between GEM applications and different implementations of platforms 
supporting GEM applications. This includes interoperability across different middleware specifications, e.g. MHP, 
OCAP 1.0 [3], and ARIB AE [5]. Implementers should consult the publisher of specifications which reference GEM 
regarding conformance. 

NOTE: The present document defines the interfaces visible to applications. Application developers should not 
assume that any related interface is available unless it is specifically listed. Terminal standards or 
implementations may have other interfaces present. 

One of the primary goals of the present document is to minimize the number of divergences between MHP and GEM 
terminal specifications, wherever practical. Divergence is defined in clause 3.1. Where divergences are inescapable, the 
present document serves as a place to document and control the permitted divergences, so that they will be predictable 
to terminal manufacturers, broadcasters, and application authors. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication and/or edition number or version number) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

Referenced documents which are not found to be publicly available in the expected location might be found at 
http ://docbox. etsi.org/Reference . 



[1] ETSI TS 101 812 (Vl.3.1): "Digital Video Broadcasting (DVB); Multimedia Home Platform 

(MHP) Specification 1.0.3". 

[2] ETSI TR 101 154 (Vl.4.1): "Digital Video Broadcasting (DVB); Implementation guidelines for 

the use of MPEG-2 Systems, Video and Audio in satellite, cable and terrestrial broadcasting 
applications". 

[3] OCAP 1 .0: "OpenCable Application Platform version 1 .0". 

NOTE: http://www.opencable.com/specifications . 

[4] ISO 639 (all parts): "Codes for the representation of names of languages". 

[5] ARIB STD-B23, "Application Execution Engine Platform for Digital Broadcasting," version 1.0, 

June 5, 2003. 

NOTE: http : // w w w . arib . or . j p 

[6] IETF RFC 3073 "Portable Font Resource (PFR) - application/font-tdpfr MIME Sub-type 

Registration". 
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3 



Definitions and abbreviations 



3.1 



Definitions 



3.1.1 



Definitions from MHP 



MHP [1], clause 3.1 is included in the present document, with the following notes and modifications. 



In the body of definitions only, the interpretations described in clause 4.2 are to be applied. 



3.1 .2 Definitions introduced by GEM 



For the purposes of the present document, the following terms and definitions apply: 

divergence: everything that violates an assertion in a specification and/or a conformance clause 

NOTE: A divergence from the MHP specification is when a correctly written conformance test for an MHP 
specification assertion would fail. 

enumeration: type that includes in its definition an exhaustive list of possible values for variables of that type 

NOTE: In Java, enumerations are not directly supported, but they are often simulated with a set of integer 
constants. 

functionally equivalent: A functionally equivalent requirement is one that specifies behaviour that performs 
substantially the same function with substantially the same behaviour as the original specification, as seen from an 
application's point of view 

NOTE: There are several clauses within the present document that do not require literal conformance with the 

corresponding requirement in the underlying MHP specification, but allow for a compatible substitution. 

GEM application: application that is written only to the interfaces and semantic guarantees defined in GEM 

NOTE: A suitably signalled GEM application will run on an MHP terminal, or on any terminal that complies to a 
GEM terminal specification, e.g. on OCAP and the ARIB AE. 

GEM terminal: terminal or other device that conforms to a GEM Terminal Specification 

NOTE: Examples of GEM terminals include an MHP terminal, an OCAP terminal (including the POD) and a 
terminal supporting the ARIB AE. 

GEM Terminal Specification: specification that includes all normative and selected optional elements of its 
underlying GEM document, and provides additional specifications that describe functionally equivalent elements for 
each and every clause of the underlying GEM document where required 

standard definition: MPEG-2 main level at main profile, as defined in TR 101 154 [2] 

trigger: event that may cause a change in the behaviour of an application that registers interest in such events 

NOTE: Triggers come from the broadcast stream. The trigger may include a reference to time relative to the NPT 
of a media stream or be asynchronous. It also can carry some semantically significant payload in order to 
affect changes in an application based on information not available at the time an application was written. 
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3.2 Abbreviations 

For the purposes of the present document, the abbreviations defined in MHP [1] and the following apply: 



AIT 


Annlipntion Information Tnhlp 

rtJJJJll^HLlVJll AlllVJlllltlLlVJll J. O.L/1C 


API 


Annlipntion Prngrammm o Fntprfsipp 


CA 


Conditional Access 


CLUT 


Colour Lookup Table 


nsivicc 


Oi(Titn1 ^Itorntrf 1 TVTpHin f~V^ m m 11 nH nnH f^ontrol 

LSlglL&l OLVJltlgC lVACLlltl lllllla.llLl till LI V^VJllLl VJ1 


DVB-J 


DVR-Tava 

i~y v jj j a v ti 


GEM 


filoballv Fxecntable MHP 

VJ1WL>LH1V LAL V. LI Itl U IV. 1V11 11 


ID 


IDentifier 


IP 


Tntpvrif^t Protocol 

111LC111CL riULULUl 


MHP 


lV/Ti 1 1 ti mpHi a T-ToTTif 3 Platform 

1V1 Lll 11 1 1 IV. U Itl 11VJ111C 1 ItlLlVJl 111 


NPT 


Normal Play Time 


NTSC 


National Television Systems Committer 


OCAP 


OpenCable Applications Platform 


POD 


Point Of Deployment 


SI 


Service Information 


SSL 


Secure Sockets Layer 


TCP 


Transmission Control Protocol 


TLS 


Transport Layer Security 


UDP 


User Datagram Protocol 


UTF8 


Universal Transformation Format 8 


XML 


extensible Markup Language 



4 General considerations and conventions 

4.1 General considerations 
4.1.1 Purpose 

The GEM document is not intended, and should not be used, as a complete terminal specification. It is a framework 
upon which a GEM terminal specification can be created. 

The Multimedia Home Platform (MHP) middleware standard defines a comprehensive platform that enables interactive 
television services to be deployed that are interoperable across any manufacturer's implementations of the standard. 
MHP is a comprehensive specification of a receiving device (an MHP terminal). MHP terminals receive digital video 
broadcasting services based on MPEG-2 standards for various transmission media including satellite, cable, terrestrial 
and microwave. The transport layer may be DVB-T, DVB-C or DVB-S. 

One element of the MHP standard is a description of the terminal facilities that can be exploited by applications that 
form a part of a broadcast service. These facilities may be exposed via Application Programming Interfaces (APIs); 
such APIs carry semantic guarantees. Similarly, receiver functionality can be exposed with a declarative content format 
that contains semantic guarantees. Another element of the MHP standard is the specification of the terminal hardware 
and signalling infrastructure that allows it to be connected to any DVB-T, DVB-C or DVB-S network. 

In some regions, markets and/or networks, it is impractical to adopt DVB-T, DVB-C or DVB-S signalling. For 
example, in the United States, there is a significant investment in infrastructure that cannot be easily converted. In 
Japan, the terrestrial broadcasting standard, while very similar to DVB-T, is not the same, and contains elements that 
make the adoption of the full MHP standard for terminals impractical. 

Despite these regional differences, it is desirable to be able to execute a GEM application as part of a service that is 
carried over different network infrastructure. Such interoperability can be achieved, as long as the middleware standard 
supports the same APIs and semantic guarantees. 
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The present document for the Global Execution of MHP services (GEM) defines the APIs, semantic guarantees, and 
content formats that can be relied upon in all interactive television standards and specifications that support 
globally-interoperable MHP applications. Any such specification based on GEM shall normatively reference the GEM 
specification in its entirety, and shall fulfil the normative requirements of GEM. 

The present document does not provide a complete specification sufficient to implement a device. Additional normative 
elements are required. 

4.1.2 Format 

The present document takes the form of a large number of normative references to the MHP specification. It does not 
invent new APIs or features; rather, it selects those portions of the MHP specification that define interfaces into 
terminal functionality. The GEM specification does not state how the receiver has to be built or what network 
infrastructure has to underlie the implementation; it is limited to specifying the behaviour and interfaces that globally 
interoperable applications may rely on. 

This set of interfaces includes the vast majority of those that are defined in MHP. In certain rare cases, MHP contains 
APIs and/or other features that are inextricably tied to the specifics of the DVB network, e.g. the precise details of DVB 
service information. In these rare cases, it is impractical to require the behaviour specified by the MHP. In these cases, 
the appropriate elements of the MHP specification are explicitly called out as not being required by the GEM 
specification. In general, these features are not of interest to interoperable broadcast applications; they might be in MHP 
in support of other usage scenarios, such as an EPG provided by a network operator. 

4.1.3 Inclusion of MHP features 

4.1.3.1 Subsetting prohibited 

Specifications that reference the present document shall include it in its entirety. It is prohibited to base any 
specification on the present document if the referencing document does not require all normative requirements of the 
present document. 

4.1.3.2 Supersetting permitted 

If a GEM terminal specification wishes to include APIs, signalling or behaviours defined in MHP [1] that are not 
required by GEM, it may do so as described in clause 15.6, "Functional Equivalents" . 

4.1 .4 Addition of non-GEM interfaces 

GEM terminal specifications may add public interfaces, provided that they are added in a namespace that does not 
conflict with GEM. For example, OCAP 1.0 [3] defines extensions in the Java package org . ocap. 

GEM terminal specifications and GEM terminals shall not require that such extension interfaces be called by GEM 
applications in order to enable behaviour that is normatively required by the present document. 

4.1.4.1 DVB-J enumerations 

A GEM terminal specification shall not add new values to an enumeration that is returned from a method defined by the 
present document. 

NOTE: For example, the interface org . dvb . net . rc . RCInterf ace defined in annex R introduces an 
enumeration that is returned by the method getType ( ) . This enumeration includes the values 
TYPE_CATV, TYPE_DECT, etc. It is not permissible to attempt to subdivide one of these types by 
introducing new enumeration values in a different namespace. See also the example in clause 14.9. 

4.1 .5 Application areas 

In this version of the GEM specification, the same application areas as MHP [1], clause 0.2 are considered. 
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4.1.6 Profiles 

The informative text in MHP [1], clause 0.3 describes the MHP approach to profiles. The profiles defined in the present 
document are modelled on a similar scheme. 

4.1 .7 Full conformance with the present document 

To be "fully conformant" with the present document, GEM terminals shall conform to at least one of the profiles 
defined in clause 15 Detailed platform profile definitions". Further, GEM terminals shall be conformant with any one 
of the following specifications: 

• TS 101 812 [1] (MHP 1.0.X); 

• OCAP1.0[3]. 

For avoidance of doubt, equipment which is fully conformant with the entire present document apart from the above 
clause is not fully conformant with the present document. 

4.2 Conventions 

4.2.1 References within the MHP specification 

MHP [1] contains numerous internal references. In certain cases, a clause of the MHP specification that is referenced by 
GEM will refer to a clause of the MHP specification that is not referenced by GEM, or to a clause whose requirements 
are modified by GEM. In the preparation of the GEM document, every effort has been made to identify these internal 
references, and indicate where they do not apply or where they should be interpreted as referring to a corresponding 
clause of GEM. 

In case of error, such internal MHP references should be interpreted as referring to the appropriate clause of GEM. That 
is, if GEM modifies or removes a normative requirement of MHP, for the purposes of GEM any references to that 
clause of the MHP specification shall be interpreted as referring to the appropriate clause of GEM, unless there is an 
explicit statement to the contrary in the present document. 

4.2.2 Terminology in the MHP specification 

4.2.2.1 MHP 

The present document makes numerous references to MHP [1]. When a clause of the MHP specification is referenced 
from GEM, for the purposes of GEM references to MHP are to be interpreted to apply to GEM, and to GEM terminal 
specifications. Similarly, "MHP implementations" and "MHP terminal" are to be interpreted as "implementations of 
terminal specifications based on MHP" etc. "MHP application" is to be interpreted as "GEM application". 

4.2.2.2 Resident navigator 

MHP [1] uses the terms "navigator" and "resident navigator". It is noted that in GEM terminal specifications, it is 
permissible for some of the functions of the navigator to be delegated to an entity that is not part of the resident 
software of the terminal, e.g. the OCAP 1.0 [3] monitor application. 

Downloaded or other resident applications that perform some of the policy decisions or functionality of the MHP 
navigator shall implement a policy that is consistent with the requirements of the present document. 

4.2.2.3 DVB service 

For the purposes of the present document, references within MHP [1] to DVB services shall be interpreted as meaning 
any services that carry GEM applications. 
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4.2.3 Inclusion of clauses of the MHP specification 

Unless otherwise noted, inclusion of a clause or annex of MHP [1] implies inclusion of all clauses. 

4.2.4 Conventions within the present document 

Use of the term "GEM" within a normative clause of the present document shall be interpreted as referring to the 
present document. 

5 Basic architecture 

GEM does not mandate a basic architecture. Clause 5 of MHP [1] defines a basic architecture for MHP terminals. This 
is to be taken as an informative example of one possible architecture for GEM terminal specifications. 

6 Transport protocols 

6.1 Introduction 

In order to be able to talk to the external world, a GEM terminal has to communicate through different network types. 

Broadcast only services are provided on systems consisting of a downstream channel from the Service Providers to 
Service consumers. 

Interactive services are provided on systems consisting of a downstream channel together with interaction channels. 
NOTE: MHP [1] clause 6.1 provides background material on the transport protocols for MHP terminals. 

6.2 Broadcast channel protocols 

This clause deals with DVB defined or referenced broadcast channel protocols. This clause does not consider other 
protocols and the APIs that would provide access to them. 

Other protocols and their APIs are considered as extensions to the present document, see annex H. 

NOTE: Figure 8 in MHP [1], clause 6.2 shows the broadcast channel protocol stack for MHP. As some of the 

protocols are not required by the present document, not all elements of this figure necessarily apply. See 
clause 15.6, "Functional Equivalents" . 

The full details of APIs that provide DVB-J applications with access to broadcast protocols are in clause 9. The last 
paragraph of MHP [1], clause 6.2 places a normative requirement related to conditional access descrambling and the 
section filter API. This requirement applies to GEM terminal specifications that include the MHP definition of the 
functional equivalent named "Conditional Access" as specified in clause 15.6, "Functional Equivalents" . 

6.2.1 MPEG-2 transport stream 

MHP [1], clause 6.2.1 is included in the present document. 

6.2.2 MPEG-2 sections 

MHP [1], clause 6.2.2 is included in the present document. 

6.2.3 DSM-CC private data 

MHP [1], clause 6.2.3 is included in the present document. 
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6.2.4 DSM-CC data carousel 

MHP [1], clause 6.2.4 is included in the present document. 

6.2.5 Object carousel 

MHP [1], clause 6.2.5 is included in the present document, with the following notes and modifications. For this clause, 
subclauses are only included as explicitly indicated. 

Use of the Object Carousel protocol as defined by MHP [1], clause 6.2.5 is not required for GEM terminal 
specifications. MHP [1], clause 6.2.5 shall apply to GEM terminal specifications that include the MHP definition of the 
functional equivalent named "Object Carousel" as specified in clause 15.6, "Functional Equivalents" . GEM terminal 
specifications that do not include this MHP definition shall specify a functional equivalent that satisfies the 
requirements of the API specified in Annex P (normative): 

Broadcast transport protocol access". MHP [1], clause 6.2.5 is an example of such a mechanism, and is informative for 
these GEM terminal specifications. 

6.2.5.1 DVB-J class files 

MHP [1], clause 6.2.5.1 is included in the present document, with the following notes and modifications. 

If the terminal specification does not use the BIOP::FileMessage structure, then the equivalent mechanism for 
delivering a file shall be used to deliver a "class" file, as described in of MHP [1], clause 6.2.5.1. 

6.2.5.2 DVB-HTML document files 

MHP [1], clause 6.2.5.2 is not relevant to the present document. 

6.2.5.3 Loss of carousel behaviour 

MHP [1], clause 6.2.5.3 is included in the present document, with the following notes and modifications. 

The conditions for permanent loss of a carousel may be specified differently from MHP in GEM terminal specifications 
that do not include the MHP definition of the functional equivalent named "Object Carousel" in clause 15.6, "Functional 
Equivalents" , therefore the reference to MHP [1], clause B.2.11 does not apply to these GEM terminal specifications. 
However, GEM terminal specifications shall specify conditions for permanent loss of a carousel. The present document 
does include MHP [1], clause 9.1, thus the conditions for temporary disconnection and reconnection of a carousel as 
defined in MHP [1], clause 9.1.5 do apply to all GEM terminal specifications. Thus, the language in MHP [1], 
clause 6.2.5.3 following the first paragraph do apply to the present document. 

6.2.6 Protocol for delivery of IP multicast over the broadcast channel 

MHP [1], clause 6.2.6 "DVB Multiprotocol Encapsulation" is included in the present document, with the following 
notes and modifications. 

Use of this protocol is not required for GEM terminal specifications, however some mechanism for delivery of IP 
multicast over the broadcast channel shall be specified if support for IP over the broadcast channel is supported. 

NOTE: This feature is optional in all profiles of the present document. 

6.2.7 Internet Protocol (IP) 

MHP [1], clause 6.2.7 is included in the present document. 

6.2.8 User Datagram Protocol (UDP) 

MHP [1], clause 6.2.8 is included in the present document. 
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6.2.9 Service information 

MHP [1], clause 6.2.9 is included in the present document, with the following notes and modifications. 

Use of DVB service information is not required for GEM terminal specifications, however some mechanism for 
delivery of service information that is sufficient for the SI access mechanisms required by GEM shall be specified. 
MHP [1], clause 6.2.9 may be taken as an informative example of such a mechanism for GEM terminal specification 
that do not include the MHP definition of the functional equivalent named "SI" as specified in clause 15.6, "Functional 
Equivalents" . 

6.2.10 IP signalling 

MHP [1], clause 6.2.10 is included in the present document, with the following notes and modifications. 

Use of this signalling is not required for GEM terminal specifications, however a functional equivalent that satisfies the 
requirements of MHP [1], clause 1 1.5.2 is required if support for IP over the broadcast channel is supported. 

NOTE: This feature is optional in all profiles of GEM. 



6.3 Interaction channel protocols 



MHP [1], clause 6.3 is included in the present document, with the following notes and modifications. For this clause, 
subclauses are only included as explicitly indicated. 

Some of the protocols shown in the diagram are not required by the present document in any profile. 

6.3.1 Network Dependent Protocols 

MHP [1], clause 6.3.1 is included in the present document, with the following notes and modifications. 

NOTE: The protocols listed in this clause are not explicitly required in any profile of the present document, or of 
any profile in MHP [1]. 

6.3.2 Internet Protocol 

MHP [1], clause 6.3.2 is included in the present document 

6.3.3 Transmission Control Protocol 

MHP [1], clause 6.3.3 is included in the present document. 

6.3.4 UNO-RPC 

MHP [1], clause 6.3.4 is included in the present document. 

6.3.5 UNO-CDR 

MHP [1], clause 6.3.5 is included in the present document. 

6.3.6 DSM-CC User to User 

MHP [1], clause 6.3.6 is included in the present document. 
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6.3.7 Hypertext Transfer Protocol (HTTP) 

6.3.7.1 HTTP 1.1 

MHP [1], clause 6.3.7.1 is included in the present document 

6.3.8 Service Specific 

MHP [1], clause 6.3.6 is included in the present document, with the following notes and modifications. 

GEM terminal specifications that wish to include the functionality provided by this definition may substitute a 
functional equivalent. 

NOTE: This functionality is not required by any profile in the present document. 

6.3.9 User Datagram Protocol 

MHP [1], clause 6.3.9 is included in the present document. 

6.3.10 DNS 

MHP [1], clause 6.3.10 is included in the present document. 

7 Content formats 

7.1 Static formats 

7.1.1 Bitmap image formats 

7.1 .1 .1 Image encoding restrictions 

MHP [1], clause 7.1.1.1 is included in the present document. 

7.1.1.2 JPEG 

MHP [1], clause 7.1.1.2 is included in the present document. 

7.1.1.3 PNG 

MHP [1], clause 7.1.1.3 is included in the present document. 

7.1.1.4 GIF 

MHP [1], clause 7.1.1.4 is included in the present document. 

7.1.2 MPEG-2 l-Frames 

MHP [1], clause 7.1.2 is included in the present document. 

7.1.3 MPEG-2 Video "drips" 

MHP [1], clause 7.1.3 is included in the present document. 
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7.1 .4 Monomedia format for audio clips 

MHP [1], clause 7.1.4 is included in the present document. 

7.1.5 Monomedia format for text 

MHP [1], clause 7.1.5 is included in the present document. 

7.2 Broadcast streaming formats 

7.2.1 Audio 

At least one format for streaming audio shall be specified in a GEM terminal specification. 

7.2.2 Video 

At least one format for delivering standard definition streaming video shall be specified in a GEM terminal 
specification. 

7.2.3 Subtitles 

MHP [1], clause 7.2.3 is included in the present document, with the following notes and modifications. 

Support for DVB subtitles, teletext subtitles or any other form of subtitles is optional in the present document. 

NOTE: OCAP 1.0 [3] does not include support for subtitles. It does include US closed-captioning which is 
somewhat similar, but has different regulatory requirements and usage models. 

7.3 Resident fonts 

MHP [1], clause 7.3 is included in the present document. 

7.4 Downloadable fonts 

MHP [1], clause 7.4 is included in the present document. 

7.5 Colour representation 

MHP [1], clause 7.5 is included in the present document. 

7.6 MIME types 

MHP [1], clause 7.6 is included in the present document, with the following notes and modifications: 

GEM terminal specifications may replace the entry "application/dvb.pfr" with "application/font-tdpfr" as defined in 
RFC 3073 [6] if they wish. 

NOTE: The entries for "image/dvb. subtitle", "text/dvb. sub title", "text/dvb. teletext" and "multipart/dvb. service" 
refer to content types for which support is not required by the present document. 
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8 DVB-HTML 

The GEM specification provides the basic definitions needed for integration of DVB-HTML applications into a 
subsequent version of GEM: 

• Definition of the term "DVB-HTML application," from MHP [1], clause 3.1; 

• A framework of requirements on the signalling of applications that can be extended to support DVB-HTML in 
the future. 

A definition of the content and application format from the HTML family is not in this version of the present document. 



9 Application model 

9.1 Broadcast GEM applications 

MHP [1], clause 9.1 is included in the present document, with the following notes and modifications. 

In this clause, the terms "AIT" and "application descriptor" are to be interpreted as referring to the application 
description defined in clause 10.4 of the present document. The term "DVB service" is to be interpreted as meaning 
"service." Additionally, attention is drawn to the general rules in clause 4.2. 

Support for host control tune requests is not mandatory in the present document, thus the language in the first paragraph 
of clause 9.1.1 relating to these tune requests only applies if such control is present in the terminal specification. 

In clause 9.1.5, the reference to MHP [1], clause 6.2.5.3 is to be interpreted as referring to clause 

6.2.5.3 of the present document. The language at the end of MHP [1], clause 9.1.5 relating to the PMT information only 
applies to terminal specifications that feature this signalling. 

9.2 DVB-J model 

MHP [1], clause 9.2 is included in the present document, with the following notes and modifications. 

The reference to the application_control_code parameter of the AIT in MHP [1], clause 9.2.3.2 is to be interpreted as 
referring to the application_control_code defined in clause 10.4 of the present document. 

9.3 DVB-HTML model 

MHP [1], clause 9.3 is included in the present document, with the following notes and modifications. 

In MHP [1], clause 9.3.2.2, the reference to clause 10 pertaining to the signalling of an HTML application does not 
apply. An abstract model for the signalling of an HTML application will be defined in a future version of the present 
document. All references to signalling in clauses 9.3.2.2 and 9.3.2.3 are to be read as referring to this abstract model. 

9.4 Inter-application resource management 

MHP [1], clause 9.4 is included in the present document, with the following notes and modifications. 

The reference to the application_priority field in the application descriptor is to be interpreted as referring to the 
application_priority defined in clause 10.4 of the present document. 

Some downloaded resident applications specified as extensions to the present document may perform some of the 
functions of the MHP navigator, e.g. the monitor application defined OCAP 1.0 [3]. In this case, such downloaded 
software shall implement a policy that is consistent with the requirements of the present document, e.g., MHP [1], 
clause 9.4. 
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1 Application signalling 

10.1 Introduction 

This clause covers the following topics: 

• Identification and launching of applications associated with a service. 

• Requirements on the signalling that enables a broadcast to manage the lifecycle of applications. 

MHP [1] contains a model of signalling that fulfils the requirements of GEM, but other signalling is possible. Broadly 
speaking, GEM places requirements on both the format of an application and requirements underlying its signalling. 
GEM does not, however, define the signalling that shall be used or the packaging of applications; this is left for 
GEM-based specifications to define. 

MHP [1], clause 10.1 and its subclauses contains introductory remarks about MHP's signalling and may be taken as 
informative. 

1 0.1 .1 Summary of requirements on common signalling 

The minimum signalling requirements for any GEM application are summarized as follows: 

• Some form of Application Description (see clause 10.4) with information sufficient to: 

identify the source of the application code and other assets; 
identify the application's application ID and organization ID; 
identify the name of the application. 

1 0.1 .2 Summary of additional signalling for DVB-J applications 

The minimum additional signalling requirements for DVB-J applications are summarized as follows: 

• A DVB-J Specific Application Description (see clause 10.5) with information sufficient to: 

signal parameters to the application; 
indicate the initial class of the application. 

10.2 Program specific information 

A service carrying GEM applications shall contain information sufficient to locate the following: 

• the Application Description (see clause 10.4) for each application in the service; 

• the source of the application code and data. 

10.3 Locators within an application description 

Some fields of the application description contain locators, e.g. locators to a directory containing certain kinds of files. 
These locators can be to any transport defined within a GEM terminal specification, e.g. they can be locators to an 
object carousel, part of a data carousel, an http URL, etc. GEM does not mandate any particular transport. It does, 
however, require at least one transport that is capable of carrying the information needed to launch applications. This 
transport shall be capable of carrying files, or directory hierarchies containing files. The ability to list the contents of a 
directory is optional. 
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10.4 Application description 

The Application Description provides full information on an application, its parameterization, the required activation 
state of it etc. Specifications based on GEM shall permit the signalling of multiple applications per service, without any 
arbitrary upper bound less than 255. 

Data in the Application Description allows the broadcaster to request that the GEM terminal change the activation state 
of an application. 

MHP [1], clause 10.4 defines an Application Information Table that fulfils this requirement. 

1 0.4.1 Application description transmission and monitoring 

It shall be possible to arrange for signalling such that the maximum time interval between the moment the application 
description is updated and the moment the new version is detected by the terminal will be no more than 30 s. 

1 0.4.2 Visibility of application description 

If an application tunes away from a transport stream where its signalling is carried without selecting a new service, it 
shall be permitted to continue running even if the application description is no longer available to the GEM terminal. 
For example, MHP [1], clause 10.4.4 defines behaviour consistent with this requirement. 

1 0.4.3 Content of the application description 

The Application Description describes applications and their associated information. It shall contain information 
sufficient to derive the following: 



Table 1 : Application description 



Function 


Type 


application_type 

organization_id 

application_id 

applicat ion_control_code 

applicat ion_prof iles_count 

for (i=0; KN1; i + +) { 

applicat ion__prof ile 

version . major 

version . minor 

version .micro 

} 

service„bound_f lag 
visibility 

applicat ion_prior it y 

applicatio n_n ame 

applicat ion_icon_lo cat or_count 

for (i=0; i<N2; i++) { 
application_icon_locator 
applicat ion_icon„f lags 

} 


enumeration 

32 bit unsigned integer 

16 bit unsigned integer 

enumeration 

4 bit unsigned integer 

16 bit unsigned integer 
8 bit unsigned integer 
8 bit unsigned integer 
8 bit unsigned integer 

boolean 

enumeration 

8 bit unsigned integer 

String 

unsigned integer 
Locator 

16 bit unsigned integer 



application_type: Identifies the type of application. Specifications based on GEM shall provide a mechanism for 
indicating those application types defined in MHP [1], clause 10.4.6, e.g. DVB-J and DVB-HTML. 

organization_id: An organization_id, as defined in MHP [1], clause 10.5.1 under organization_id. In GEM, inclusion 
of this value in the "leaf" certificate of an authenticated application is required, as it is in MHP. 

application_id: An application_id, as defined in MHP [1], clause 10.5.1 under application_id. 

application_control_code: An application control code, as defined in MHP [1], clause 10.6.2.1. Support for the 
REMOTE application type is not required, but may optionally be present in GEM terminal specifications. 
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application_profile: Information sufficient to derive the MHP profile on which this application could execute, as 
defined in MHP [1], clause 10.7.3. 

application_profiles_count: The number of application profiles signalled for this application. 

version.major: The major sub-field of the profile version number, as defined in MHP [1], clause 10.7.3. 

version.minor: The minor sub-field of the profile version number, as defined in MHP [1], clause 10.7.3. 

version.micro: The micro sub-field of the profile version number, as defined in MHP [1], clause 10.7.3. 

The four fields above indicate the minimum MHP profile on which an application will run. For example, an application 
that relies on the guarantees of GEM 1 .0 would run on an appropriate profile of MHP 1 .0.2. The underlying signalling 
of the application shall indicate the minimum profile that the application requires in a way that can be mapped to MHP 
profiles and the MHP version number. 

service_bound_flag: A service bound flag, as defined in MHP [1], clause 10.7.3. Terminal specifications based on 
GEM are required to support the MHP semantics of this field. 

visibility: A visibility field, as defined in MHP [1], clause 10.7.3. 

application_priority: An application priority, as defined in MHP [1], clause 10.7.3. Terminal specifications based on 
GEM shall support at least 32 priority levels, with the semantics spelled out in MHP's definition of this value. 

application_name: A string that names the application in a way meant to be informative to the user. The signalling 
shall support strings whose UTF8 encoding is up to 128 bytes, not including any termination character. It is permissible 
to signal more than one application name, e.g. the application name could be given in several different languages, with a 
method for determining which one is to be presented to the user, as is done in MHP. In all cases, it shall be possible to 
associate an ISO 639 [4] language code with each application name. It shall be possible to signal any string that can be 
represented with UTF8. 

application_icon_locator_count: The number of application icon locators associated with this application. Signalling 
to support values of and 1 shall be present. Terminal specifications based on GEM may support any number of 
application icon locators. 

application_icon_locator: Information sufficient to derive a locator to a directory containing application icons. The 
application icons shall be in files in the directory indicated by this locator, in the format specified in MHP [1], 
clause 10.7.4.2. 

application_icon_flags: Flags describing the icon files in the directory identified by the application_icon_locator, in 
the format specified in MHP [1], clause 10.7.4. 

NOTE: MHP [1] defines a test_application_flag that allow test applications to be broadcast without being displayed 
on consumer equipment that has not been put in a special "test mode." Equivalent functionality is not 
required by GEM, however, GEM terminal specification authors may wish to consider such functionality.. 



If an application with a service_bound_flag of is running when a service selection is performed, it shall continue to 
run in a newly selected service if the same application is signalled in the new service. To efficiently support this feature 
on services that do not contain the application code, it may be desirable to have signalling equivalent to that described 
in MHP [1], clause 10.7.5. 



10.4.4 



Applications from previously selected services 



1 0.5 DVB-J specific application description 



10.5.1 



General 



Additional signalling specific to DVB-J applications shall be present in GEM terminal specifications. 



ETSI 



24 ETSI TS 1 02 81 9 V1 .2.1 (2004-05) 

1 0.5.2 Content of DVB-J application description 

For each application description that refers to a DVB-J application, it shall be possible to signal information sufficient 
to derive the following: 



Table 2: DVB-J application description 



Function 


Type 


for (i=0; i<N; i++) { 




dvb j_app_parameter 

} 


String 


base_directory 


Locator 


for (i=0; i<N; i++) { 




classpath_element (optional) 

} 


Locator 


initial_class_name 


String 



dvbj_app_parameter: A string that is passed to the application as parameters. The signalling shall support parameter 

strings such that a minimum total length of 240 bytes can be supported. The length is calculated as the sum of 

(1 + the sum of (1 + length(dvbj_app_parameter)) where the length of a parameter is the length of that parameter string 

encoded in UTF8, with no termination character. It shall be possible to signal any string that can be represented with 

UTF8. 

NOTE: MHP [1] exceeds this requirement somewhat; see MHP [1], clause 10.9.1. 

initial_class_name: The fully-qualified name of the initial class of this application. This class shall implement the Xlet 
interface. The signalling shall support UTF8 encoding up to 80 bytes, not including any termination character. It shall 
be possible to signal any string that can be represented with UTF8. 

base_directory: A locator specifying a directory. This directory is used as a base directory for relative path names. This 
base directory is automatically considered to form the first directory in the class path (after the path to the system's 
classes). 

classpath_element: GEM-based terminal specification may include optional signalling to indicate a list of other 
locators to be added to an application's class path. For example, MHP [1], clause 10.9.2 defines the classpath_extension 
for this purpose. If support for this is included in a terminal specification, there may be restrictions placed on these 
locators, e.g. that they represent sub-directories of the base_directory. 



1 1 DVB-J platform 

11.1 The virtual machine 

MHP [1], clause 11.1 is included in the present document. 

1 1 .2 General issues 

MHP [1], clause 1 1.2 is included in the present document, with the following notes and modifications. 

MHP [1], clause 11.2.11.1 applies only for GEM terminal specifications that include the MHP definition of the 
functional equivalent named "SI" as defined in clause 15.6, "Functional Equivalents" . 

1 1 .3 Fundamental DVB-J APIs 

MHP [1], clause 11.3 is included in the present document, with the following notes and modifications. 

NOTE 1: As with other clauses, MHP [1], clause 1 1.3.1.1 bullet point g applies to the present document. Thus, all 
GEM terminal specifications require support for the system property "dvb . persistent . root". 
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MHP [1], clause 1 1.3.1.6 includes a definition for the behaviour of URL . get Content ( ) . Part of this definition is a 
priority for the data type of the URL, including the content type descriptor in an object carousel. For GEM terminal 
specifications that do not include the MHP definition of the functional equivalent named "Carousel" as defined in clause 
15.6, "Functional Equivalents" , this requirement does not apply; however, if the functionally equivalent signalling 
contains data type information, it is recommended that it be given the same priority as the content type descriptor is 
given in MHP. 

MHP [1], clause 1 1.3.2.1 contains a reference to the class org . davic . net . dvb . DVBLocator. This class is not 
required by GEM. For GEM terminal specifications that do not include the MHP definition of the functional equivalent 
named "Content Referencing" as defined in clause 15.6, "Functional Equivalents" , this is to be interpreted as allowing a 
valid locator as described in the following two paragraphs. 

The present document does not require a particular text encoding for locators, however terminal specifications are 
required to define such a text encoding. The entities for which a text encoding is required are specified in clause 6.3.3. 

Where a locator text encoding is required, a locator may be constructed from the text representation using the factory 
method defined in the class javax . tv . locator . LocatorFactory. 

NOTE 2: Portable GEM applications should not contain hard-coded text representations for locators, as it is likely 
that the locators will vary across networks. If an application needs to be signalled with values for locators, 
they can be passed in as Xlet arguments, or put in a small text file that is read from the carousel. 



1 1 .4 Presentation APIs 

MHP [1], clause 1 1.4 is included in the present document, with the following notes and modifications. 

NOTE 1: As a consequence of clause 4.1.4, the requirements of MHP [1], clause 11.4.1.4 are required of all 

GEM-based terminal specifications; as a further consequence, GEM terminal specifications shall not 
define extensions that have to be invoked by applications in order to obtain the behaviour mandated by 
the present document. 

NOTE 2: MHP [1], clause 1 1.4.1.4 contains a requirement that applications cover at least 3 % of the visible area on 
the screen under certain circumstances. Obviously, the pixel values given only apply to systems with the 
standard definition resolution required by MHP; on other systems, the 3 % requirement applies, but 
results in different pixel values. 

NOTE 3: Alters the definition of the constant java . awt . event . KeyEvent . CHAR_UNDEFINED. The return 
value of j ava . awt . event . KeyEvent . getKeyChar ( ) is defined in terms of 
CHAR_UNDEFINED. This value may only be returned for KEY_PRESSED and KEY_RE LEASED events; 
it is never returned for KEY_T YPED events. In no case should an interoperable application rely on the 
return value of getKeyChar ( ) for a KEY_PRESSED or KEY_RELEASED event; further, the value 
returned for an undefined key is not defined interoperably and may vary across platform implementations. 

The last paragraph of MHP [1], clause 1 1.4.2.2 places a requirement on the handling of DVBLocators. For GEM 
terminal specifications that do not include the MHP definition of the functional equivalent named "Content 
Referencing" as defined in clause 15.6, "Functional Equivalents" , this paragraph does not apply. Instead, the present 
document requires that any information in a locator beyond that identifying a service (e.g. the time of a specific 
program event) is to be ignored by JMF players. See also clause 6.3.3. 

The following classes are required by MHP [1], clause 11.4.2.5.1 but are not required by the present document: 



org . dvb . media . Subt it lingEvent Control 
org . dvb . media . SubtitleAvailableEvent 
org . dvb .media . SubtitleListener 
org . dvb . media . SubtitleNotAvailableEvent 
org . dvb . media . Subt it leNot Select edEvent 
org . dvb . media . Subt it leSelect edEvent 
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• org . dvb . media . CAStopEvent 

• org . dvb . media . CAException 

The following class is required by MHP [1], clause 1 1.4.2.5.2 but is not required by the present document: 

• org . da vie . media . SubtitlingLanguageControl 

Some of the classes referenced in MHP [1], clauses 1 1.4.2.5.4 and 1 1.4.2.5.5 are not required as specified by other 
clauses in the present document. 

MHP [1], clause 1 1.4.2.7 refers to the component tags of a locator. For the purposes of GEM, this is to be interpreted as 
meaning the description of the required components in a locator. This clause also places semantic requirements on 
subtitling-related APIs. As these APIs are optional in GEM, these requirements apply only if these APIs are required by 
the GEM terminal specification. 

1 1 .5 Data access APIs 

11.5.1 Broadcast Transport Protocol Access API 

MHP [1], clause 11.5.1 is included in the present document, with the following notes and modifications. 

The reference to annex P is to be read as referring to annex P. 

The reference to clause B.5 is to be read as referring to clause B.2.1.1. 

1 1 .5.2 Support for Multicast IP over the Broadcast Channel 

MHP [1], clause 1 1.5.2 is included in the present document. 

1 1 .5.3 Support for IP over the Return Channel 

MHP [1], clause 1 1.5.3 is included in the present document. 

1 1 .5.4 MPEG-2 Section Filter API 

MHP [1], clause 1 1.5.4 is included in the present document. 

1 1 .5.5 Mid-Level Communications API 

MHP [1], clause 1 1.5.5 is included in the present document, with the following notes and modifications. 
The reference to annex R is to be read as referring to annex R of the present document. 

1 1 .5.6 Persistent Storage API 

MHP [1], clause 1 1.5.6 is included in the present document. 

1 1 .6 Service information and selection APIs 
1 1 .6.1 Signalling-bound service information API 

The DVB specific SI API is not required in the present document. Thus, MHP [1], clause 1 1.6.1 is not included in the 
present document. 

GEM terminal specifications shall provide any needed service information API specific to their signalling. 
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1 1 .6.2 Service selection API 

MHP [1], clause 1 1.6.2 is included in the present document. 

11.6.3 Tuning API 

MHP [1], clause 1 1.6.3 is included in the present document, with the following notes and modifications. 

The reference to the DvbLocator class does not apply to the present document for GEM terminal specifications that 
do not include the MHP definition of the functional equivalent named "Content Referencing" as defined in clause 15.6, 
"Functional Equivalents" . 

The reference to MHP [1], clause 1 1.7.6 is to be read as referring to clause 1 1.7.6 of the present document. 

1 1 .6.4 Conditional access API 

The present document does not require a conditional access subsystem, nor does it place requirements on one if it is 
present. Thus, MHP [1], clause 1 1.6.4 is not included in the present document. 

GEM terminal specifications may define any needed conditional access API. 

1 1 .6.5 Protocol independent SI API 

MHP [1], clause 1 1.6.5 is included in the present document, with the following notes and modifications. 

The mapping of the protocol independent SI API onto the underlying SI protocol is not defined in the present document. 
Thus, the reference to MHP [1], annex O does not apply for GEM terminal specifications that do not include the MHP 
definition of the functional equivalent named "SI" as defined in clause 15.6, "Functional Equivalents" . However, GEM 
terminal specifications shall provide a mapping of the protocol independent SI API onto their SI signalling, as specified 
in annex O of the present document. 

1 1 .7 Common infrastructure APIs 

1 1 .7.1 APIs to support DVB-J application lifecycle 

MHP [1], clause 11.7.1 is included in the present document, with the following notes and modifications. 

NOTE: Support of the xlet properties "dvb . org . id", "dvb . app . id" and "dvb . caller . parameters" is 
required. 

In MHP [1], clause 1 1.7.1.1, the reference to the DVB-J application descriptor is to be interpreted as referring to 
clause 10.5.2, "Content of DVB-J application description". The text requiring that a specific text encoding be used does 
not apply to the present document. 

1 1 .7.2 Application discovery and launching APIs 

This API is formed of the org . dvb . application package defined in annex S. 

NOTE: This is the same API as in MHP [ 1 ] . 

In GEM terminal specifications that include the MHP definition of the functional equivalent named "Carousel" in clause 
15.6 Functional equivalents", full support of all properties defined for use with the method 

AppAt tributes . get Property in MHP[1] clause 1 1.7.2 is required. In GEM terminal specifications that do not 
include the MHP definition of this functional equivalent, support of these properties is optional. 

The following table defines the source of the information which shall be used for methods returning information from 
entries in the application database for an application signalled in an application description. 
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Table 3: Information source for methods on AppAttributes 



Method 


Information source 


getName() 


One of the names that can be found in the application_name of the 
Application description. 


getName(String IS0639code) 


A name of the application_name of the Application description 
corresponding to the specified language, if available. 


getNames() 


All of the names for the application which can be found in the 
application_name of the Application description and their ISO 639 [4] 
language code. 


getProfiles() 


The set of profiles indicated in the application profile of the Application 
description. 


getPriority() 


The value indicated for the application priority of the Application 
description. 


getVersions(String profile) 


The values version. major, version. minor and version. micro for the 
specified profile from the Application description. 


getlsServiceBound() 


True if the service_bound_flag of the Application description indicates 
true. Otherwise false. 


isStartable() 


There is no information source for this method, the return value is derived 

do ojJtiOlllcU 111 Lllc IlltJIIIUU Ucoul ipilUI I. rUI lllc pUipUoc Ul lllc lllclllUU 

description, remote applications are as specified in the GEM terminal 
specification, if they are supported. 


getldentifier() 


The organizationjd and application id of the Application description. 


getServiceLocator() 


If remote applications are supported, the locator for a remote application 
shall encapsulate the values found in the appropriate signalling in the 
terminal specification. 


getLocatorf) 


The application icon locator of the Application description. 


getlconFlags() 


The application_icon_flags of the Application description. 



1 1 .7.3 Inter-application communication API 

MHP [1], clause 1 1.7.3 is included in the present document. 

1 1 .7.4 Basic MPEG concepts 

MHP [1], clause 1 1.7.4 is included in the present document, with the following notes and modifications. 

The classes DvbElementaryStream, DvbService, and DvbTransportStream are not required by the present 
document. The note requiring the return of the DVB specific subclass for methods returning instances of elementary 
stream, service or transport stream does not apply to GEM terminal specifications that do not include these classes. 

1 1 .7.5 Resource notification 

MHP [1], clause 1 1.7.5 is included in the present document. 

1 1 .7.6 Content referencing 

This API is formed of the DAVIC Locator class and the javax . tv . locator package, both as described in 
MHP [1], clause 1 1.7.6. The DAVIC class DvbLocator is not required by the present document. GEM terminal 
specifications may define one or more subclasses of the DAVIC Locator class. 

The signature of the org . davic . net . Locator class shall be extended with: 

• "implements javax . tv . locator . Locator" . 

The createFactory ( ) method of javax . tv . locator . LocatorFactory shall always return 

org . davic .net.Locator(s) which implement the javax .tv. locator. Locator interface when provided 

with a locator syntax that is valid in the terminal specification. See also clause 6.3.3. 
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In the present document, methods whose signature has a return type of org . davic . net . Locator or 
javax . tv . locator . Locator shall return an instance of org . davic . net . Locator (or a subclass of that) 
where the locator returned can be represented by the locator syntax described by the terminal specification. In this case, 
the locator returned shall contain an identification of a service. 

Any optional extensions of locators (e.g. for specifying components, events, etc.) are considered in a comparison and if 
they are not equally present in both locators then the comparison shall fail. 

For the above locators "best effort" comparison shall be exact. 

The protected constructor of LocatorFactory is for implementation use. MHP applications shall not subclass 
LocatorFactory. Implementations are not required to behave correctly if they should do this. 

1 1 .7.7 Common error reporting 

MHP [1], clause 1 1.7.7 is included in the present document, with the following notes and modifications. 

Support for the interface NotAuthorizedlnterf ace and the exception NotAuthorizedException is not 
required for GEM terminal specifications that do not include the MHP conditional access API. 

11.8 Security 

MHP [1], clause 1 1.8 is included in the present document, with the following notes and modifications. For this clause, 
subclauses are only included as explicitly indicated. 

11.8.1 Basic Security 

MHP [1], clause 11.8.1 is included in the present document. 

1 1 .8.2 APIs for return channel security 

MHP [1], clause 1 1.8.2 is included in the present document. 

1 1 .8.3 Additional permissions classes 

MHP [1], clause 1 1.8.3 is included in the present document, with the following notes and modifications. 

For GEM terminal specifications that do not support the MHP definition of the functional equivalent named 
"conditional access", the package org . dvb . net . ca is not required. 

For GEM terminal specifications that do not support the MHP definition of the functional equivalent named "SI", the 
class org . dvb . net . tuning . DvbNetworklnterf aceSIUtil is not required. 

1 1 .8.4 General Security Issues 

MHP [1], clause 1 1.8.4 is included in the present document. 

11.9 Other APIs 
11.9.1 Timer support 

MHP [1], clause 11.9.1 is included in the present document. 

NOTE: The minimum repeat interval of 40ms in MHP was motivated by a standard definition frame rate of 

25 Hz, however this was not meant to imply that the timer could be used for frame-accurate animation. 
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1 1 .9.2 User settings and preferences API 

MHP [1], clause 1 1.9.2 is included in the present document. 

1 1 .9.3 Profile and version properties 

MHP [1], clause 1 1.9.3 is included in the present document, with the following notes and modifications. 

All of the system properties defined in this clause is required by the present document. For GEM-based terminal 
specifications, the properties indicating the profile ("mhp.profile.enhanced_broadcast", 

"mhp. profile. interactive_broadcast" and "mhp. profile. internet_access") are to be interpreted as referring to the profile 
descriptions in clause 15 of the present document. The properties referring to version numbers are to be interpreted as 
referring to the corresponding MHP version number. 

NOTE: This means that a receiver implementing a terminal specification based on the interactive broadcast 

profile of GEM would return property values consistent with the MHP [1] interactive broadcast profile. 

11.10 Java permissions 

MHP [1], clause 1 1.10 is included in the present document, with the following notes and modifications. 

In MHP, the only mechanism by which an application may be trusted, and thus request additional permissions, is for 
that application to be signed. As described in clause 12.1.3, GEM terminal specifications may add other mechanisms for 
establishing that an application is trusted. Thus, in this clause the term "signed application" is to be interpreted as 
meaning an application that is eligible for being granted permissions beyond the MHP sandbox. "Unsigned application" 
is to be interpreted as meaning an application that has not been packaged in such a way. 

Any additional mechanism complementing the MHP codesigning model for granting trust to an application shall be 
defined in a GEM-based terminal specification. 

MHP [1], clause 1 1.10.2.2 refers to object carousels. This is to be interpreted as meaning object carousels, or any other 
filesystem that may be mounted using the DSMCC APIs. 

The class org . dvb . net . ca . CAPermission is not required by the present document; MHP [1], clause 1 1.10.2.3 
does not apply for GEM terminal specifications that do not include the MHP definition of the functional equivalent 
named "Conditional Access" as defined in clause 15.6, "Functional Equivalents" . 

11.11 Content referencing 
11.11.0 General 

The following mapping shall be used between the types of locator defined in table 6 and the DVB-J methods defined in 
this clause. It lists the Java methods and constructors that accept or return (as defined by their method signature) 
instances of org . davic .net .Locator, javax . tv . locator . Locator, javax . media . MediaLocator 
or their subclasses. The external form of the locators shall as described in table 6 for the corresponding entity being 
referenced. Where the same method is listed as accepting multiple forms of locator, then it is required to accept all 
forms listed in this clause. 

Where a method listed below is defined (in its specification) to check its input then it shall only accept the forms of 
locator listed below as being valid for that method from among those defined in the present document and in the GEM 
terminal specification. Other forms of locator from among those defined in the present document shall be rejected as 
specified for the method concerned. If a method does not specify a means of rejecting inappropriate locators then it 
shall fail silently apart from Exceptions and Events which do not check their input and where it is the responsibility of 
the platform to use correct locators when constructing them. The present document does not prevent methods accepting 
other forms of locator that are not defined in the present document. 
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11.11.1 Transport stream 

MHP [1], clause 11.11.1 is included in the present document, with the following notes and modifications. 

The term "DVB locators" is considered to refer to all valid locators as described in table 6. The informative note at the 
end of this clause referring to DVB-SI tables does not apply for GEM terminal specifications that do not include the 
MHP definition of the functional equivalent named "Content Referencing" as defined in clause 15.6. "Functional 
Equivalents" . 

11.11.2 Network 

MHP [1], clause 11.11.2 is included in the present document, with the following notes and modifications. 
The term "DVB network" is to be interpreted as referring to a valid network, as described in table 6. 

11.11.3 Bouquet 

MHP [1], clause 1 1.1 1.3 is not included in the present document. 

11.11.4 Service 

11.11 .4.1 MPEG/GEM specific service 

MHP [1], clause 1 1.1 1.4.1 is included in the present document, with the following notes and modifications. 

The term "DVB service" is to be interpreted as meaning "GEM service". "DVB locator" is to be interpreted as meaning 
"GEM locator." 

The following methods are not required by the present document: 

• org . davic . net . ca . CAModule . buyEntitlement ( ) ; 

• org . davic . net . ca . CAModule . queryEntitlement ( ) ; 

• org . dvb . si . SIDatabase . retrieveSIService ( ) ; 

• org . dvb . si . SIDatabase . retrievePMTService ( ) ; 

• org . dvb . si . PMTService . getDvbLocator ( ) ; 

• org . dvb . si . SIBouquet . getSIServiceLocators ( ) ; 

• org . dvb . si . SI Service . getDvbLocator ( ) ; 

• org . davic . net . ca . TuneRequestEvent - constructor; 

• org . davic . net . ca . TuneRequestEvent . getLocator ( ) . 

The semantics for these methods described in MHP [ 1 ] , clause 1 1 . 1 1 .4. 1 only apply if the GEM terminal specification 
requires a given method. 

11.11.4.2 Generic service 

MHP [1], clause 1 1.1 1.4.1 is included in the present document, with the following notes and modifications. 
The term "DVB specific service" is to be interpreted as meaning "GEM service". 
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11.11.5 Program event 

MHP [1], clause 1 1.1 1.5 is included in the present document, with the following notes and modifications. 
The term "DVB Event" is to be interpreted as meaning "program event". 
The following methods are not required by the present document: 

• org . davic . net . ca . CAModule . buyEntitlement ( ) ; 

• org . davic . net . ca . CAModule . queryEntitlement ( ) ; 

• org . dvb . si . SIEvent . getDvbLocator ( ) . 

The semantics for these methods described in MHP [ 1 ] , clause 11.11.5 only apply if the GEM terminal specification 
requires a given method. 

11.11.6 MPEG elementary stream 

MHP [1], clause 1 1.1 1.6 is included in the present document, with the following notes and modifications. 

The phrase "DVB locators including multiple component tags" is to be interpreted as meaning "GEM locators including 
a reference to multiple components." In the bulleted list, the note "shall also accept multiple component tag "dvb:" 
locator" shall be interpreted as referring to these same GEM locators. 

The following methods are not required by the present document: 

• org . dvb . si . SIDatabase . retrievePMTElementaryStreams ( ) ; 

• org . dvb . si . PMTElementaryStream . getDvbLocator ( ) ; 

• org . davic . net . ca . DescramblingStoppedEvent . getServiceLocator ( ) ; 

• org . davic . net . ca . DescramblingStartedEvent . getServiceLocator ( ) . 

The semantics for these methods described in MHP [ 1 ] , clause 11.11.6 only apply if the GEM terminal specification 
requires a given method. 

11.11.7 File 

MHP [1], clause 1 1.1 1.7 is included in the present document, with the following notes and modifications. 

The note about "instances of v dvb: "locator including dvb_abs_path" shall be interpreted as meaning locators referring 
to File or Directory entities, as defined in table 6. 

11.11.8 Directory 

MHP [1], clause 1 1.1 1.8 is included in the present document, with the following notes and modifications. 
The phrase " v dvb:' locator" shall be interpreted as meaning GEM locator. 

11.11.9 Drip feed decoder 

MHP [1], clause 1 1.1 1.9 is included in the present document. 

11. 11. 10 Irrelevant 

MHP [1], clause 1 1.1 1.10 is included in the present document. 
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11.11.11 Methods working on many locator types 

The following methods used in the present document work on many locator types. The locator types which each method 
is required to support are listed for each of the methods concerned. 

• javax . tv . locator . LocatorFactory . transf ormLocator - transforms a transport independent 
locator into a transport dependent one: 

required to accept instances of org . davic . net . Locator describing a transport independent 
service; 

required to return instances of org . davic . net . Locator describing a transport dependent service. 

• javax . tv . locator . LocatorFactory . createLocator - creates a locator from a string: 

required to accept valid GEM locators (see clause 6.3.3) and return corresponding instances of 

org . davic . net . Locator. 

• javax . tv . service . SIManager .registerlnterest - accepts a locator referencing one or more 
SIElements as input. 

• javax . tv . service . SIManager . retrieveSIElement - accepts a locator referencing one or more 
SIElements as input: 

both these methods are required to accept locators referencing: -Bouquet, Network, Event, 
ElementaryStream, Service, TransportStream. 

• javax . tv . service . SIElement . get Locator: 

returns a locator for "this SIElement" as specified by the JavaTV specified sub-interfaces. 
GEM terminal specifications may add rules similar to the above for locator types that they specify. 

11.11.12 Support for the HTTP Protocol in DVB-J 

MHP [1], clause 1 1.1 1.12 is included in the present document. 



12 Security 
12.1 Introduction 

This clause covers the following areas of security: 

• Authentication of applications; 

• Security policies for applications; 

• Authentication and privacy of the return channel communications; 

• Certificate management. 
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12.1.1 Overview of the security framework for applications 

MHP [1], clause 12.1.1 is included in the present document, with the following comments and modifications. 
The last paragraph of this clause is not included in the present document, and is replaced by the following: 

• Applications that are eligible to be trusted shall be identified with an application_id from range of values 
allocated for signed applications in MHP [1] (see MHP [1] clause 12.5.1, table 12,"Value ranges for 
application_id"). Applications that are not eligible to be trusted shall be identified with an application_id from 
MHP's unsigned applications range. For an application with an application_id from the signed application 
range that requires signing to establish trust, if it is not signed it is considered to have failed authentication. An 
application with an application_id from the unsigned application range is treated as not eligible to be trusted 
even if the files might be transmitted with signatures. 

In the last paragraph of clause 12.1.1, "applications that are signed" is to be interpreted as referring to any application 
that is eligible to be trusted, either through the MHP mechanism or through other mechanisms, as specified in the 
present document in clause 12.1.3. "unsigned applications" is to be interpreted as referring to applications that are not 
eligible to be trusted, through the MHP mechanism or other mechanisms. 

12.1.2 Overview of return channel security 

MHP [1], clause 12.1.2 is included in the present document. 

1 2.1 .3 Extensions to MHP application signing framework 

In MHP, the only mechanism by which an application may be trusted, and thus request additional permissions, is for 
that application to be signed. Terminal specifications based on GEM may introduce additional mechanisms for 
establishing that an application is trusted. These mechanisms may involve some form of codesigning. 

Any such extensions to the MHP security framework, whether they involve codesigning or not, shall: 

• Require that trusted applications be identified with an application_id from the signed applications range, 
as described in clause 12.1.1; 

• Refuse to grant permissions outside of the set granted to unsigned applications in MHP, unless those 
permissions are explicitly requested in the signalling; 

• Must be completely specified in the GEM terminal specification. 

12.2 Authentication of applications 

MHP [1], clause 12.2 is included in the present document. 

12.3 Message transport 

MHP [1], clause 12.3 is included in the present document. 

12.4 Detail of application authentication messages 

MHP [1], clause 12.4 is included in the present document. 

NOTE: The exact file names, locations and syntaxes described in this clause must be supported. This includes the 
requirement in clause 12.4.3.1 that the last certificate in a CertificateFile be the root certificate. 

1 2.5 Profile of X.509 certificates for authentication of applications 

MHP [1], clause 12.5 is included in the present document. 
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1 2.6 Security policy for applications 

MHP [1], clause 12.6 is included in the present document, with the following notes and modifications. 

As described in clause 12.1.3, mechanisms other than MHP codesigning may be used to determine if additional 
permissions should be granted to applications. As a consequence, in clause 12.4 the term "signed application" is to be 
interpreted as meaning an application that has been packaged in such a way that it is eligible for being granted 
additional permissions, either via the MHP signing mechanisms or through other mechanisms. "Unsigned application" 
is to be interpreted as meaning an application that has not. 

An alternative permission request mechanism may be used in order to request additional permissions over and above the 
ones defined in the present document. Any such alternative permission request mechanism shall not conflict with the 
MHP one and shall be completely defined in the GEM terminal specification with the following constraints: 

• the permission requests shall be contained in a file encoded in XML format; 

• the alternative permission request file shall be located in the directory that contains the initial file of the 
application; 

• the formal public identifier of the alternative DTD shall identify the organization that specifies the alternative 
mechanism; 

• the name of an alternative permission request file (PRF) shall be prefixed with a name identifying the GEM 
terminal specification, e.g. ocap.<application_name>.perm; 

• the alternative DTD shall include at least all of the same XML elements and attributes as those defined in the 
DVB PRF; 

• any additional permissions that are needed beyond those defined in GEM shall have their XML element and 
attribute names prefixed by a string identifying the GEM terminal specification. 

The following rules shall apply for the processing of PRFs by a GEM terminal: 

1) If there is only a DVB PRF present, the GEM terminal shall use it. 

2) If there is a platform-specific PRF (i.e. an OCAP PRF) present on the corresponding target platform (i.e. an 
OCAP terminal), then the GEM terminal shall use it exclusively. 

3) If there is a platform-specific PRF present on a non-corresponding target platform, then it shall be ignored. In 
this case, if a DVB PRF is present, the GEM terminal shall use it. 

NOTE 1: The policy for granting of permissions outlined in MHP [1], clause 12.6.1 is required to be supported. It is 
possible that these policy decisions will be made by an element that is downloaded to the terminal, 
e.g. OCAP 1.0 [3] defines a "monitor application" that makes policy decisions. In cases such as this, the 
downloaded element is required to implement a policy consistent with the present document. 

NOTE 2: The exact syntax of the permission request file specified in MHP [1], clause 12.6.2 is required to be 

supported. Because of the rules in MHP [1], clause 14.3, it cannot be extended by adding tag definitions. 

NOTE 3: If a terminal cannot support functionality implied by a permission tag, it must still support the syntax of 
the permission tag. E.g. capermission tag must be supported, even if support for the MHP CA APIs is 
present. 

Table 54 in MHP [1], clause 12.6.2.4 contains a reference to the name initial_class_byte. For the present 
document, this is to be interpreted as referring to initial_class_name from table 2. 

MHP [1], clause 12.6.2.8 discusses the permissions for conditional access. As discussed in clause 11.10 of the present 
document, the class CAPermission is not required to be present for GEM terminal specifications that do not include the 
MHP definition of the functional equivalent named "conditional access" as defined in clause 15.6, "Functional 
Equivalents" ; for such GEM terminal specifications the policies specified in MHP [1] clauses 12.6.2.8.1 and 12.6.2.8.2 
do not apply. However, the syntax of the capermission tag as specified in MHP [1], clause 12.6.2.8.3 shall be 
supported in all cases; if the MHP definition of "conditional access" is not included, it is to be silently ignored. 
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MHP [1], clause 12.6.2.9 refers to the AIT of a service. For the present document, this is to be interpreted as referring to 
the application description, as described in clause 10.4. 

NOTE 4: The return channel access policy and permission described in MHP [1] are required to be supported. 

Attention is drawn to the note at the end of clause 12.6.1 relating to the return channel permission and 
return channel connections where it is not necessary to dial a phone, e.g. cable modems. 

12.7 Example of creating an application that can be 
authenticated 

MHP [1], clause 12.7 is included in the present document. 

12.8 GEM/MHP certification procedures 

Certification procedures are outside the scope of the present document. 

12.9 Certificate management 

12.9.1 Certificate Revocation Lists 

MHP [1], clause 12.9.1 is included in the present document. 

1 2.9.2 Root certificate management 

12.9.2.1 Introduction 

MHP [1], clause 12.9.2.1 is included in the present document with the following notes and modifications: 

• MHP [1] specifies a root certificate management protocol that fulfils the requirements of GEM, but another 
protocol syntax and another distribution means are possible. Broadly speaking, GEM places requirements on 
both the semantics of a root certificate management message and requirements underlying its processing. 
GEM does not, however, mandate the syntax of the protocol message and its distribution means; this is left for 
GEM terminal specifications to define, either by using the MHP definition or by defining a functional 
equivalent. 

1 2.9.2.2 Security of the root certificate replacement message 

MHP [1], clause 12.9.2.2 is included in the present document with the following notes and modifications: 

The reference to the nextNbOf Signature field is to be interpreted as referring to the version of 
nextNbOf Signature from the present document, as specified in clause 12.9.2.3. 

12.9.2.3 Format of RCMM 

RCMM encoding format as specified in MHP [1], clause 12.9.2.3 is not required for GEM terminal specifications. 
MHP [1], clause 12.9.2.3 shall apply to GEM terminal specifications that include the MHP definition of the functional 
equivalent named "RCMM" as defined in clause 15.6, "Functional Equivalents" . GEM terminal specifications that do 
not include this MHP definition shall specify a functional equivalent that satisfies the requirements of this clause. 
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The unsigned RCMM message shall contain information sufficient to derive the following : 

Table 5: Root Certificate Management Message description 



Function 


Type 


thisUpdate 


Date 


nextNbOfSignatures 


8-bit Unsigned Integer 


addedCertificates 


set of certificates 


removedCertificates 


set of certificate references 



GEM-based terminal specifications are allowed to define additional fields in the RCMM message. 

The signatures shall subsequently be computed on the whole content of the unsigned RCMM, including possible 
extensions defined by GEM-based terminal specifications. 



thisUpdate: 
nextNbOfSignatures: 

addedCertificates: 
removedCertificates: 



Date of issue of the message. 

This field is used to change the minimum number of valid signatures required for an 
RCMM message. This value will be applied to the next RCMMs not to itself. 

List of root certificates to be added in persistent storage. 

Reference of the root certificates to be removed from persistent storage. 



1 2.9.2.4 Distribution of root certificate replacement messages 

MHP [1], clause 12.9.2.4 is not required for GEM terminal specifications. MHP [1], clause 12.9.2.4 shall apply to GEM 
terminal specifications that include the MHP definition of the functional equivalent named "RCMM" as defined in 
clause 15.6, "Functional Equivalents" . GEM terminal specifications that do not include this MHP definition shall 
specify a functional equivalent that satisfies the requirements of this clause. 

RCMM messages shall be distributed to the MHP terminals in the broadcast MPEG Transport Stream. The distribution 
mechanism to be specified in a GEM terminal specification that do not support the MHP definition of the functional 
equivalent named "RCMM" as defined in clause 15.6, "Functional Equivalents" shall take into account the need to 
broadcast a set of historic RCMM messages in addition to the latest one. See MHP [1], clause 12.9.2.4. 



12.9.2.5 RCMM Processing 

MHP [1], clause 12.9.2.5 is included in the present document with the following notes and modifications: 

References to RCMM messages named "dvb.rcmm.<x>" shall be interpreted as the set of historic RCMM messages as 
mentioned in clause 12.9.2.4 of the present document. References to RCMM message named "dvb.rcmm" shall be 
interpreted as the most recent RCMM message. 

The reference to the thisUpdate field is to be interpreted as referring to the version of thisUpdate from the 
present document, as specified in clause 12.9.2.3. 

The reference to the nextNbOf Signature field is to be interpreted as referring to the version of 
nextNbOf Signature from the present document, as specified in clause 12.9.2.3. 

1 2.9.2.6 Example: Renewal of a root certificate 

MHP [1], 12.9.2.6 is included in the present document. 

12.9.3 Test certificates 

MHP [1] 12.9.3 is included in the present document. 

12.10 Security on the return channel 

MHP [1], clause 12.10 is included in the present document. 
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12.1 1 The internet profile of X.509 (informative) 

MHP [1], clause 12.1 1 is included in the present document. 

12.12 Platform minima 

MHP [1], clause 12.12 is included in the present document. 



1 3 Graphics reference model 

13.0 General 

MHP [1], clause 13 is included in the present document, with the notes and modifications detailed in the following 
clauses. 

13.1 Supported graphics resolutions 

MHP [1], clause 13 contains references to the platform minima in annex G, e.g. in clauses 13.2.1.3 and 13.3.6.1. For the 
present document, these references are to be interpreted as referring to annex G. 

Table 62 in MHP [1], clause 13.2.1.3 is an informative listing of typical resolutions and their pixel aspect ratios. This 
may not apply in all regions, e.g. regions with NTSC standard definition. 

1 3.2 Broadcast streaming formats 

MHP [1], clause 13.4.1 mandates background players for the broadcast streaming formats. The present document does 
not mandate a particular broadcast streaming format, e.g. Standard Definition 25Hz MPEG-2 Video is not required by 
the present document. However, as described in clause 7.2.2 a GEM terminal specification shall include some 
mechanism for delivering MPEG-2 audio and video programming in standard definition. For these formats, background 
JMF players shall be created. Thus, the last paragraph of clause 13.4.1 applies to this player. 

13.3 Subtitles 

As signalling to support subtitles is not required by the present document, MHP [1], clause 13.5 only applies to GEM 
terminal specifications for which subtitling is available. If subtitling signalling is available, the presentation of subtitles 
shall follow the model specified in MHP [1], clause 13.5. Further, the introduction to subtitles contained in MHP [1] 
clause 13.1 and the components related to subtitles in figure 17 in MHP [1] clause 13.2.1 only apply to GEM terminal 
specifications that include support for subtitling. 

NOTE: US closed captioning is not the same thing as subtitles, thus, in systems where closed captioning is 
available but subtitling is not, clause 13.5 is optional. 



14 System integration aspects 
14.1 Namespace mapping 

The present document does not mandate any particular format for locators. Note, however, that clause 6.3.3 requires 
that terminal specifications based on the present document define some text representation for certain entities. 
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14.2 Reserved names 

MHP [1], clause 14.2 is included in the present document. 

14.3 XML notation 

MHP [1], clause 14.3 is included in the present document, with the following notes and modifications. 

These XML notation rules only apply to XML file formats defined in the present document, or in MHP [1]. 

In the fourth bullet item, MHP prohibits indicating an encoding attribute in an XMLDecl item to specify an encoding 
other than UTF-8. The present document relaxes this prohibition: GEM terminal specifications may extend the allowed 
XML notation by permitting other character encodings, if this extension is explicitly stated in a GEM terminal 
specification. If no encoding is specified in an XML file, however, the default shall be UTF-8. 

14.4 Network signalling (error behaviour) 

MHP [1], clause 14.4 is included in the present document. 

14.5 Text encoding of application identifiers 

MHP [1], clause 14.5 is included in the present document, with the following notes and modifications. 

The references to organization_id and application_id are to be interpreted as referring to the versions of organization_id 
and application_id from the present document. 

14.6 Filename requirements 

MHP [1], clause 14.6 is included in the present document. 

14.7 Files and file names 

MHP [1], clause 14.8 is included in the present document, with the following notes and modifications. 

The reference to "using a DVB locator including the dvb_abs_path part of the name part of the syntax" shall be 
interpreted to mean the use of a locator that refers to a file or directory, as described in clause 6.3.3. 

The locator format shall be able to reference any valid file name; at least the minima specified in clause B.2.1 shall be 
supported. 

14.8 Locators and content referencing 

Table 6 lists the types of entity that may be addressed by locators in the present document, and defines the entities for 
which a text representation is required. In the case of locators, where a text representation is required the present 
document does not specify what that representation is, however GEM terminal specifications shall supply an 
unambiguous, concrete syntax for each of these entities. 

NOTE: Clause 1 1.7.6 describes how this text representation can be used in DVB-J applications. 

The present document does not require support for addressing any other type of entity in an MHP system by locator or 
URL. 
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Table 6: Addressable entities, locators and their text representation 



Entity 


Text Representation 


Transport stream 


locator text representation shall be defined 


I NclWUI r\ 


nn ctQ nrl q rH i 7dH tovt rDnrocontQ+inr roniiiro/H 
IIU bLdl lUdlUIZcU LcAl [ c|Jl cocl 1 LdLIUI 1 Icl^UirfciU 


Service 


locator text representation shall be defined 


Service domain 


locator text representation shall be defined. 


Program Event 


locator text representation shall be defined 


MPEG Elementary Stream 


locator text representation shall be defined 


File 


file:, http: and https: URLs, as referred to in MHP [1], 
clause 14.8 

locator text representation shall be defined for files located 
within a Service domain. 


Directory 


"file:", "http:" and "https:" URLs, as referred to in MHP [1], 
clause 14.8 

locator text representation shall be defined for directories 
located within a Service domain. 


Drip feed decoder 


"dripfeed://" 



14.9 Service identification 

Java TV can support two kinds of locators for identifying a service: transport independent locators and transport 
dependent locators. Both enable global, unique identification of a service. 

A transport independent locator has additional properties: 

• It can identify two (or more) service instances as being the same service even if they for technical reasons have 
different transport dependent locators. 

It is up to the service provider to decide whether different service instances are identified as being the same 
service. 

• They can give alternate identifications for a single service. 

Terminal specifications based on GEM shall provide a textual representation for transport dependent locators. Support 
for transport independent locators is not required by the present document. 

14.10 CA system 

The present document places no requirements on a CA system, if one is present. Thus, MHP [1], clause 14.10 is not 
included in the present document. 

NOTE: GEM terminal specifications may include the MHP requirements in clause 14.10 as described in clause 
15.6, "Functional Equivalents" . 



15 Detailed platform profile definitions 
15.0 General 

This clause defines the capabilities of platforms as presented to applications. Products that claim to conform to a profile 
shall provide at least the minimum capabilities identified for the profile. In some cases this implies that specific 
hardware resources are present in the platform. 
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Table 7: Platform profile definitions 







Enhanced 


Interactive 


Area 


Specification 


Broadcast 
Profile 1 


Broadcast 
Profile 1 


Static Formats 




7.1.1.3, "PNG" +15.1, "PNG - restrictions" 


M 


M 




7.1 .1 .3, "PNG" without restrictions 






Bitmap pictures 


7.1.1.4, "GIF" 






7.1.2, "MPEG-2 l-Frames" 


M 


M 




7.1.1.2, "JPEG" + 11.11.11, "10.2" 


M 






7.1 .1 .2, "JPEG" without restrictions 




M 


Audio clips 


7.1 .4, "Monomedia format for audio clips" 


M 


M 


Video drips 


7.1.3, "MPEG-2 Video 'drips'" 


M 


M 


Text encoding 


7.1 .5, "Monomedia format for text" 


M 


M 


Broadcast streaming formats 


Video 


7.2.2, "Video" 


M 


M 


Audio 


7.2.1, "Audio" 


M 


M 


Subtitles 


7.2.3, "Subtitles" 






Fonts 




Character set see annex E 


M 


M 


Built in 


Metrics see annex D 
Face: UK RNIB "Tiresias" 






Downloadable 


7.4, " Downloadable fonts" 


M 


M 


Broadcast channel protocols 




6.2.2, "MPEG-2 sections" 


M 


M 




6.2.5, "Object carousel" 


M 


M 




IP Multicast stack based on: 


O 


Ro 




6.2.6, "Protocol for delivery of IP multicast over the broadcast 








channel" 








6.2.7, "Internet Protocol (IP)" 








6.2.8, "User Datagram Protocol (UDP)" 






Interaction channel protocols 


TCP/IP 


6.3.3 "Transmission Control Protocol (TCP)" 




M 


6.3.2 "Internet Protocol (IP)" 






UDP/IP 


6.3.2, "Internet Protocol (IP)" 

6.3.9, "User Datagram Protocol (UDP)" 




M 


HTTP 


6.3.7.1, "HTTP 1.1" 




O 


DSMCC-UU 
RPC 


6.3.4, "UNO-RPC" 




O 


6.3.5, "UNO-CDR" 

6.3.6, "DSM-CC User-to-User" 






DNS 


6.3.10, "DNS" 




M 


DVB-J 


Core 


1 1 .3, "Fundamental DVB-J APIs" 


M 


M 


Presentation 


1 1 .4, "Presentation APIs" 


M (note) 


M (note) 




1 1 .5.1 , "Broadcast Transport Protocol Access API" 


M 


M 




1 1 .5.2, "Support for Multicast IP over the Broadcast Channel" 


O 


Ro 




1 1 .5.3, "Support for IP over the Return Channel" 




M 


Data Access 


1 1 .5.4, "MPEG-2 section filter API" 


M 


M 




1 1 .5.5, "Mid-Level communications API" as modified by 1 1 .5, "Data 




M 




access APIs" 








1 1 .5.6, "Persistent Storaqe API" 


M 


M 




1 1 .6.1 , "Signalling-bound service information API" 


M 


M 


Service 


1 1 .6.2, "Service selection API" 


M 


M 


Information and 


11.6.3, "Tuning API" 


M 


M 


Selection 


1 1 .6.4, "Conditional access API" 








1 1 .6.5, "Protocol independent SI API" 


M 


M 




1 1 .7.1 , "APIs to support DVB-J application lifecycle" 


M 


M 




1 1 .7.2, "Application discovery and launching APIs" 


M 


M 


Common 
Infrastructure 


1 1 .7.3, "Inter-application communication API" 


M 


M 


1 1 .7.4, "Basic MPEG concepts" 


M 


M 


1 1 .7.5, "Resource notification" 


M 


M 




1 1 .7.6, "Content referencing" 


M 


M 




1 1 .7.7, "Common error reporting" 


M 


M 
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Area 


opjclslllUdLIUII 


tnnancea 

DlUdUUdol 

Profile 1 


inieracTive 

R V f\ 9 H f* 9 c t 
DIUdtlLdbl 

Profile 1 


Security 


1 1 .8.1 "Basic Security" 


M 


M 


1 1 .8.2 "APIs for return channel security" 




M 


1 1 .8.3 "Additional permissions classes" 


M 


M 


Others 


1 1 .9.1 , "Timer support" 


M 


M 


1 1 .9.2, "User settings and preferences API" 


M 


M 


1 1 .9.3, "Profile and version properties" 


M 


M 


NOTE: The javax.tv.graphics.TVContainer.getRootContainer method shall return an instance of 
org.havi.ui.HScene or null. 



Key 




Not applicable/Not required 





Optional feature in the receiver 


Ro 


Recommended optional feature in the receiver 


M 


Mandatory feature in the receiver 



If a GEM terminal specification wishes to include APIs, signalling or behaviours defined in MHP [1] as functional 
equivalents, it shall do so by referencing the corresponding entry in clause 15.6, "Functional Equivalents" and not by 
directly referencing MHP. 

15.1 PNG - restrictions 

MHP [1], clause 15.1 is included in the present document. 

1 5.2 Minimum media formats supported by DVB-J APIs 

MHP [1], clause 15.2 is included in the present document, with the following notes and modifications. 
Support for subtitles is optional. 

15.3 JPEG - restrictions 

MHP [1], clause 15.3 is included in the present document. 

15.4 Locale support 

MHP [1], clause 15.4 is included in the present document. 

NOTE: Terminal specifications may, of course, guarantee support for locales in addition to UK English, however, 
support for the UK English locale is required by the present document. 

1 5.5 Video raster format dependencies 

This clause addresses the aspects of the present document that vary as a consequence of the video raster format. 

15.5.1 Standard Definition (PAL/SECAM or NTSC resolution) 
1 5.5.1 .1 Logical pixel resolution 

The logical pixel resolution shall be 72 dots per inch. 



ETSI 



43 



ETSI TS 102 819 V1.2.1 (2004-05) 



15.6 Functional equivalents 

The table 8 lists the set of mandatory and optional functional equivalents. Those elements marked mandatory shall be 
defined in a GEM terminal specification. Those marked optional may be defined in a GEM terminal specification. 

If a GEM terminal specification wishes to include technology defined in MHP [1] that is not required by GEM, it may 
do so only for those elements listed in table 8 and shall be conformant with the clauses referenced by table 8. 

Each reference to a clause in MHP [1] in table 8 refers to the original MHP technology, including all references within 
MHP [1]. For references in the "MHP definition" column, the rule about internal references in clause 4.2.1 of the 
present document does not apply. 

NOTE: This means that references in the "MHP definition" column refer to the original MHP clauses unmodified 
by GEM. 

Each functional equivalent is identified by a name in the leftmost column of table 8. 

For each mandatory named functional equivalent, the GEM terminal specification shall explicitly indicate that it adopts 
the entire MHP Definition as referenced in table 8 or shall specify a replacement as required by the corresponding GEM 
clause(s) in table 8. 

For each optional named functional equivalent, the GEM terminal specification shall explicitly indicate whether it is 
supported. If supported, the GEM terminal specification shall indicate that it adopts the entire MHP Definition as 
referenced in table 8 or shall specify a replacement as required by the corresponding GEM clause(s) in table 8. 



Table 8: Functional equivalents 



Name 


GEM Clause(s) 


MHP Definition 


Enhanced 
Broadcast 
Profile 1 


Interactive 
Broadcast 
Profile 1 


Arch 


5, "Basic Architecture" 


MHP [1], clause 5, "Basic 
Architecture" 


O 


O 


Carousel 


6.2.5, "Obiect carousel" 
See also 1 1 .7.2, "Application 
discovery and launchinq 
APIs" 


MHP [1], clause 6.2.5, "DSMCC 
User-to-user Object Carousel" 


M 


M 


IP MPE 


6.2.6, "Protocol for delivery of 
IP multicast over the 
broadcast channel" 


MHP [1], clause 6.2.6, "DVB 
Multiprotocol Encapsulation" 


O 


O 


SI 


6.2.9, "Service information" 


MHP [1], clause 6.2.9, "DVB 
Service Information" 


M 


M 


1 1 .6.1 , "Signalling-bound 
service information API" 


MHP [1], clause 11.6.1, "DVB 
Service Information API" 
MHP [1], clause 11.11.3, 
"Bouquet" 


Annex 0, "Integration of the 
JavaTV SI API" 


MHP [1], clause O, "Integration of 
the JavaTV SI API" 


Broadcast IP 
signalling 


6.2.10, "IP signalling" 


MHP [1], clause 6.2.10, "IP 
signalling" 


O 


O 


Audio 


7.2.1, "Audio" 


MHP [1], clause 7.2.1 , "Audio" 


M 


M 


Video 


7.2.2, "Video" 


MHP [1], clause 7.2.2, "Video" 


M 


M 


Subtitles 


7.2.3, "Subtitles" 


MHP [1], clause 7.2.3, "Subtitles" 


O 


O 


1 1 .4, "Presentation APIs," 
classes related to subtitles 


MHP [1], clause 11.4.2.5.1, 
classes related to subtitles 
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Name 


GEM Clause(s) 


MHP Definition 


Enhanced 
Broadcast 
Profile 1 


Interactive 
Broadcast 
Profile 1 


Application 
Signalling 


10.2, "Program specific 
information" 


MHP [1], clause 10.2, "Program 
Specific Information" 


M 


M 


10.4, "Application description" 

10.5, "DVB-J specific 
application description" 


MHP [1], clause 10.3, "Notation" 

MHP [1], clause 10.4, "Application 

Information Table" 

MHP [1], clause 10.5, "Application 

Identification" 

MHP [1], clause 10.6, "Control of 

application life cycle" 

MHP [1], clause 10.7, "Generic 

descriptors" 

MHP [1], clause 10.8, "Transport 

protocol descriptors" 

MHP [1], clause 10.9, "DVB-J 

specific descriptors" 

MHP [1], clause 10.11, "Constant 

values" 


1 1 .7.2, "Application discovery 
and launchinq APIs and 
bindings" 


MHP [1], clause 11.7.2, 
"Application discovery and 
launching APIs" 


Conditional 
Access 


1 1 .4, "Presentation APIs," 
classes related to conditional 
acess 

1 1 .6.4, "Conditional access 
API" 


MHP [1], clause 11.4.2.5.1, 
classes related to conditional 
access 

MHP [1], clause 11.6.4, 
"Conditional Access API" 

ft 1 1 I I — i r A 1 1 A A A r\ 1 1 /"\ A 

MHP [1], clause 14.10, CA 
system" 


O 


O 


Content 
Referencing 


1 1 .7.6, "Content referencing" 


MHP [1], clause 1 1 .7.6, "Content 
Referencing" 


M 


M 


11.11.11, "Methods workinq 
on many locator types" 


MHP [1], clause 11.11.11, 
"Methods working on many 
Locator types" 


14.1, "Namespace mappinq" 


A A 1 1 r~\ r J 1 1 AAA 

MHP [1], clause 14.1 , 
"Namespace mapping (DVB 
Locator)" 


14.9, "Service identification" 


MHP [1], clause 14.9, "Service 
identification" 


Graphics 
Resolution 


D.1, "Horizontal resolution" 


MHP [1], clause D.3.4.2, 
"Horizontal resolution" 


M 


M 


G.1 .1 , "Device resolution for 
Standard Definition" 


MHP [1], clause G.1 .1 , "Device 
capabilities" 


G.4, "Resident fonts and text 
renderinq" 


MHP [1], clause G.4, "Resident 
fonts and text rendering" 


Text 
Wrapping 


D.2, "Text wrapping setting is 
true" 


MHP [1], clause D.3.7.2, "Text 
wrapping setting is true" 


M 


M 


Minimum 
CLUT 


G.1 .2, "Minimum Colour 
Lookup Table" 


MHP [1], clause G.1 .5, "Colour 
capabilities" 


M 


M 


RCMM 


12.9.2, "Root Certificate 
Management" 


MHP [1], clause 12.9.2, "Root 
Certificate Management" 


M 


M 



Key 


M 


Functional equivalent required 


O 


Optional feature, no functional 
equivalent required 




Not required/Not applicable 
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16 



Registry of constants 



16.1 System constants 



MHP [1], clause 16.1 is included in the present document. 



16.2 



DVB-J constants 



MHP [1], clause 16.2 is included in the present document, with the following notes and modifications. 

Where this clause lists a constant for a class that is not required by the present document (e.g. a class in the package 
org . dvb . s i), that constant is not required. 

MHP [1], clause 16.2.2 requires the constant java . awt . event . KeyEvent . CHAR_UNDEF INED. In GEM 
terminal specifications, this constant is required to be present but its value may be either or Oxffff. 
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Annex A (normative): 

External references; errata, clarifications and exemptions 

MHP [1], annex A is included in the present document. 
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Annex B (normative): 

Broadcast filesystem and trigger transport 

B.O General 

The present document does not specify a transport protocol for broadcast file systems or for trigger (event) delivery. It 
does, however, require that GEM terminal specifications provide a mechanism for delivery of filesystems and triggers. 

NOTE: MHP [1], annex B defines a profile of DSMCC object carousels that fulfils the requirements of this 
annex. 



B.1 Service domain 

Terminal specifications based on GEM shall include a mechanism for signalling a service domain. A service domain is 
an entity that uniquely identifies a filesystem, which can contain files, directories, stream descriptions, trigger objects 
and trigger events. The format of these is described in the following clauses. This mechanism shall be sufficient to 
support all functionalities of the API defined in annex P. 

Terminal specifications based on GEM shall define a syntax for a locator to refer to a service domain. This locator 
syntax shall support the encoding of an optional integer, in order to accommodate the requirements of the method 
ServiceDomain.getLocator() (see clause P.2.5.3). 

A service domain provides a "mount point" for a file system. Once an application attaches to a service domain, a 
mapping from locators to files within the carousel is established. To read any object in a filesystem, a GEM application 
shall first mount a service domain, then navigate the filesystem to the desired object. The text form of a relative path to 
an object in the filesystem is represented by dvb_abs_path as specified in MHP [1], clause 14.1. 

The signalling for a service domain shall be sufficient to identify the "root" directory of a filesystem, and allow 
attaching to that filesystem. 

The details of mounting a service domain are described in annex P. 



B.2 Filesystem requirements 
B.2.1 Static requirements 

Terminal specifications based on GEM shall include a mechanism for delivering a hierarchical file system within a 
service domain. It shall be possible to construct a locator that refers to files and directories in this hierarchy. The file 
system delivery mechanism shall satisfy the following minimum requirements. Of course, in addition to these limits, 
available bandwidth and memory resources would constrain the size of what can practically be broadcast. 



Table B.1: Filesystem signalling requirements 



Area 


Minimum requirement 


Characters Allowed in File and Directory 
Names 


The ASCII character "a".."z", "A".."Z", "0".."9", "$", and After the 
first character of a file name, "." and " " (the space character) is also 
permitted 


Maximum length of file name 


200 characters 


Number of entries per directory 


500 


Maximum Directory Nesting 


20 levels 


Maximum File Length 


2 27 -1 bytes 


Caching 


See clause B. 2.1.1 
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B.2.1.1 Caching behaviour 

It shall be possible to signal along with carousel modules, information related to the caching behaviour of a GEM 
terminal. 

This signalling shall contain sufficient information to derive the following: 

Table B.2: Caching behaviour signalling requirements 



Function 


Type 


priority_value 


8 bit unsigned integer 


transparencyjevel 


8 bit unsigned integer 



Semantics of these two fields are as defined in MHP [1], clauses B.2. 2.4.2. and B.5. 

GEM terminals that support caching shall comply with those semantics. Default behaviour is as defined in 
clause B.2.2.4.2. 



B.2. 2 Filesystem updates 

It shall be possible to signal a new version of a file or directory. 



B.3 Stream description 

There shall be a signalling mechanism for sending a description of an MPEG stream. Such a stream can carry a service 
(e.g. in MHP, a DVB service). 

NOTE 1: The following requirements are modelled on DSMCC BIOP::StreamMessage. 

Stream descriptions shall be identified with a special file sent in the hierarchical filesystem described in clause B.2. This 
file shall contain information sufficient to derive the following: 



Table B.3: Stream description 



Function 


Type 


npt_source 


Reference (see text) 


stream_locator 


Locator external form 


duration 


32 bit unsigned integer 


audio„stream 


flag 


video_stream 


flag 


data_stream 


flag 


i s_mp e g_p r o g r am 


flag 



npt_source: A reference to a source of MPEG Normal Play Time (NPT). This shall be sufficient to derive NPT values, 
and the NPT rate. It may indicate that no source of NPT is associated with this stream collection. 

streamjocator: A locator that references the streams of this collection. 

duration: The duration of this stream description, in milliseconds. Signalling for this value is not required; if not 
present it shall always considered to be zero. 

NOTE 2: MHP signalling can indicate a value of up to 2 32 s with a resolution of microseconds. 

audio_stream: True if this stream contains audio. 

video_stream: True if this stream contains video. 

data_stream: True if this stream contains data. 

is_mpeg_program: An indication whether or not this stream collection is an MPEG program. 
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B.4 Trigger signalling 
B.4.0 General 

There shall be a mechanism for signalling the presence of triggers to an application, and for delivery of those triggers. 

B.4.1 Trigger object 

Triggers shall be identified with a special file sent in the hierarchical filesystem described in clause B.2. This file shall 
contain information sufficient to derive all of the contents of a Stream description, plus the following: 



Table B.4: Trigger object 



Function 


Type 


num_triggers 

for (i=0; i<N; { 

trigger_name 

event„id 

} 


16 bit unsigned integer 
string 

14 bit unsigned integer 



num_triggers: The number of trigger events identified in this trigger object. 

trigger_name: The name of a trigger event. The signalling shall support trigger names up to 200 characters long 
containing any valid 7-bit ASCII character between 32 and 126, inclusive. 

event_id: An integer uniquely identifying a trigger event within the context of the currently selected service. 
NOTE: A trigger object corresponds to a BIOP::StreamEvent message in DSMCC. 

B.4. 2 Trigger event 

It shall be possible to signal a trigger event. The signalling shall contain information sufficient to derive the following: 



Table B.5: Trigger event 



Function 


Type 


event„id 




14 bit unsigned integer 


i s_do_it_now 




flag 


mpeg_npt 




32 bit unsigned integer 


payload 




byte array 



event_id: An integer uniquely identifying a trigger event within the context of the currently selected service. 

is_do_it_now: Flag indicating if this is a "do it now" event. If true, this is a "do it now" event that is to be triggered 
upon reception. If false, this is a scheduled event to be triggered when a given NPT value is reached. 

mpeg_npt: A normal play time value of an MPEG timebase. For "do it now" events, this value is ignored. 

NOTE 1: A timebase associated with the stream identified by the Trigger object will be used by the terminal to 
send a trigger to a registered application. 

payload: A sequence of up to 220 bytes containing arbitrary data. 

NOTE 2: A trigger event corresponds to a DSMCC section carrying a stream event descriptor. 
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B.4.2.1 Extrapolation of NPT values 

Terminal specifications based on GEM shall be written such that, for broadcasts confirming to appropriate broadcast 
norms and specifications and absent reception errors, any extrapolation of NPT values shall last no more than 5 s. 

NOTE: This corresponds to the requirements in NPT signalling spelled out in MHP [1], clause B. 2.4.4, 
"Timebases". 

B.4.2.2 Monitoring of trigger events 

For each GEM application, GEM terminal specifications shall require monitoring at least one stream delivering 
scheduled stream events, and one stream delivering "do it now" stream events. For broadcasts confirming to appropriate 
broadcast norms and specifications and absent reception errors, the terminal shall raise an event in response to a 
scheduled trigger event provided that an application subscribed to the event at least 5 seconds before the scheduled 
time. 

NOTE: This corresponds to the requirements spelled out in MHP [1], clause B.2.4.5, "Monitoring Stream 
Events." MHP requires that scheduled stream event descriptors be broadcast at least 5 s before the 
scheduled time, but in GEM this requirement is not expressed, because it is a part of appropriate 
broadcast norms and specifications. 
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Annex C (informative): 
References 

C.1 Informative references from MHP 

MHP [1], annex C is included in the present document. 



C.2 Informative reference to MHP 1.1 

ETSI TS 102 812: "Digital Video Broadcasting (DVB); Multimedia Home Platform (MHP) Specification 1.1". 
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Annex D (normative): 
Text presentation 

MHP [1], annex D is included in the present document, with the notes and modifications detailed in the following 
clauses. 



D.1 Horizontal resolution 

Table D.3 in MHP [1], clause D.3.4.2 is not required for GEM terminal specifications that do not support a graphics 
device resolution of 720 x 576, however a functional equivalent shall be specified in GEM terminal specifications. 



D.2 Text wrapping setting is true 

MHP [1], clause D.3. 7. 2 may not apply for non-western languages. GEM terminal specifications that support languages 
for which MHP [1], clause D.3. 7. 2 does not apply shall provide a functional equivalent. 
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Annex E (normative): 
Character set 

MHP [1], annex E is included in the present document. 



ETSI 



54 



ETSI TS 102 819 V1.2.1 (2004-05) 



Annex F (informative): 

Authoring and implementation guidelines 

MHP [1], annex F is included in the present document. 
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Annex G (normative): 
Minimum platform capabilities 

G.1 Graphics 

MHP [1], clause G.l is included in the present document, with the notes and modifications detailed in the following 
clauses. 

G.1 .1 Device resolution for Standard Definition 

The last bullet point of MHP [ 1 ] , clause G. 1 . 1 discusses a resolution of 720 x 576. This is to be interpreted as meaning 
the appropriate resolution with the terminal in standard definition mode. 

G.1. 2 Minimum Colour Lookup Table 

MHP [1], clause G.l. 5 defines minimum colour capabilities, including a precise definition of the CLUT. This CLUT 
may be inappropriate in some locations, because it is impossible to reproduce certain colours on all devices. For 
example, some of the specified colours fall outside of the NTSC gamut, and thus cannot be reproduced on devices with 
an NTSC composite video output. For this reason, the CLUT as specified in MHP is not required, but a functional 
equivalent shall be provided. It shall support at least 139 opaque colours, 48 colours at 30 % transparency, and 1 colour 
at 100 % transparency. Where the receiver cannot implement the "ideal" value of 30 % transparency it shall replace it 
with the nearest value of semi-transparency it can implement. Semi-transparency shall not be approximated as either 
% or 100 % transparency. 

A GEM terminal specification with a different CLUT should provide a set of colours that approximates the MHP CLUT 
as closely as possible. 



G.2 Audio 

MHP [1], clause G.2 is included in the present document. 



G.3 Video 

MHP [1], clause G.3 is included in the present document. 



G.4 Resident fonts and text rendering 

MHP [1], clause G.4 is included in the present document, with the following notes and modifications. 

Table G.2 in clause G.4.1 is informative in MHP, and it may not apply to all GEM terminal specifications. For clarity 
GEM terminal specifications may specify an equivalent of these values, though if they do not this does not imply that 
table G.2 is accurate for these specifications. 
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G.5 Input events 

MHP [1], clause G.5 is included in the present document with the following notes and modifications: 

GEM-based terminal specifications are allowed to make optional the VK_TELETEXT input event. 

Some downloaded resident applications specified as extensions to the present document may perform some of the 
functions of the MHP navigator, e.g. the monitor application defined OCAP 1.0 [3]. In this case, such downloaded 
software shall implement a policy that is consistent with the requirements of the present document, e.g. MHP [1], 
clause G.5. 



G.6 Memory 

MHP [1], clause G.6 is included in the present document, with the following notes and modifications. 

The bullet point requiring enough memory to load a 720x576 8 bit PNG image is to be read as requiring a PNG image 
whose size is the same as the resolution of an HGraphicsDevice at standard definition, as discussed in clause Gl. 



G.7 Other resources 

MHP [1], clause G.7 is included in the present document, with the following notes and modifications. 

MHP [1], table G.4 refers to AIT section filtering. As an MHP AIT is not required, this entry does not apply to GEM 
terminal specifications that do not include the MHP definition of the functional equivalent named "Application 
Signalling" as defined in clause 15.6, "Functional Equivalents" . However, attention is drawn to the requirement on 
detecting application description changes in clause 10.4.1. 

The key lengths for application authentication in MHP [1], table G.4 apply only to codesigning using the MHP model. 

Table G.5 in MHP [1], clause G.7 contains an entry for conditional access. This does not apply to GEM terminal 
specifications that do not support the MHP definition of the functional equivalent named "Conditional Access" as 
specified by MHP [1]. 
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Annex H (normative): 
Extensions 

MHP [1], annex H is included in the present document. 
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Annex I (normative): 
DVB-J fundamental classes 

MHP [1], annex I is included in the present document. 
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Annex J (normative): 
DVB-J event API 

MHP [1], annex J is included in the present document, with the following notes and modifications. 

Clause 16.2, "DVB-J constants" alters the definition of the constant 

java . awt . event . KeyEvent . CHAR_UNDEF INED. The return value of 

org . dvb . event . UserEvent . getKeyChar ( ) is defined in terms of CHAR_UNDEFINED. The value of 
getKeyChar ( ) for this method is not defined in an interoperable way. In no case should an interoperable application 
rely on the return value of getKeyChar ( ) ; further, the value returned for an undefined key is not defined 
interoperably and may vary across platform implementations. 
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Annex K (normative): 
DVB-J persistent storage API 

MHP [1], annex K is included in the present document. 
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Annex L (normative): 

User settings and preferences API 

MHP [1], annex L is included in the present document, with the following notes and modifications. 

In the class org . dvb . user . GeneralPref erence, the preference "User Name" requires that name be reported as 
first name followed by last name. It is understood that "first name" and "last name" are ambiguous concepts in some 
locales. For this reason, in the present document this property is only required to contain the name of the user, in some 
order that is suitable for presentation to an end user. 
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Annex M (normative): 
SI Access API 

MHP [1] annex M is not included in the present document. 

NOTE: The MHP definition of the functional equivalent named "SI" in clause 15.6, "Functional Equivalents" 
references MHP [1] annex M. 
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Annex N (normative): 
Streamed media API extensions 

MHP [1] N is included in the present document, with the following notes and modifications. 

References to "720 x 576" frames are to be read as referring to standard definition frames, as defined in the GEM 
terminal specification. 
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Annex O (normative): 
Integration of the JavaTV SI API 

GEM terminal specifications shall contain a mapping of the Java TV SI API to the network's underlying signalling. This 
mapping shall fulfil all of the semantic guarantees required by Java TV. The Java TV SI is formed by the classes in the 
package javax . tv . si and its subpackages, as defined for the present document, including any descriptive text 
accompanying those classes. 
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Annex P (normative): 

Broadcast transport protocol access 

P.1 Overview 

This clause includes a definition of APIs in the package org.dvb.dsmcc. The API is mapped to an abstraction of 
signalling based on DSMCC as specified in MHP [1]; no requirement to use DSMCC signalling is implied. 

The API defined in this clause allows DVB-J applications direct access to information broadcast according to annex B. 
Of course, GEM terminal specifications may make other filesystems available via this API. 

To benefit from the fact that most of the functionalities are already covered by the j ava . io package, this API inherits 
from java . io and only defines the extra functionalities pertaining to: 

a) the nature of a broadcast filesystem and its latency (e.g. possibility to asynchronously load the objects). 

b) the type of the objects that can be encapsulated in a carousel and that do not exist in a classical file structure. 
These are: ServiceGateway, Stream and StreamEvent. 

An application can optionally use only the classes of java . io. Alternatively/additionally applications can use 
additional classes and methods adapted to the specific nature and latency of the network (such as for example, the 
asynchronous loading of objects). 

The following, briefly explains the functionalities offered by this API. 
The ServiceDomain class enables attaching to a Service domain. 

When attached to a Service Domain, objects are available representing the types File, Directory, Stream description, 
Trigger object and Trigger event. 

The class DSMCCOb ject is a common superclass for all of these types. It defines methods that deal with asynchronous 
or synchronous loading of Objects. 

For the File and Directory Objects, their content is accessible as it would be for a classical file system, i.e. by using the 
java . io package (e.g. for listing the objects pointed to by a Directory object, you invoke the list ( ) method of 
the java . io .File class, or to access the content of a File, you can instantiate a FilelnputStream to read the 
File, etc.) 

Additionally, the DSMCCStream and DSMCCStreamEvent classes define functionalities specific to the respective 
types of Objects (Stream description and Trigger object), enabling access to the attributes of these Objects. For the 
details of the attributes that can be accessed, refer to the documentation of these classes. 

The AsynchronousLoadingEvent class and its subclasses represent events that are sent to a listener to notify it of 
the loading of an Object that had been activated by the application (asynchronous loading mode). 

The StreamEvent class represents an abstraction of the real event that is generated, i.e. the Trigger event, which 
enables the broadcaster to synchronize the application with the stream. This class enables the access to the content of an 
event, as described in clause B.4.2. 

Finally, the StreamEventListener and AsynchronousLoadingEventListener are interfaces that shall be 
implemented by the application, in order for it to receive the respective StreamEvents and 
AsynchronousLoadingEvent s. 
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P. 2 The org.dvb.dsmcc package 
P.2.0 General 

This package is derived from the org . dvb . dsmcc package as defined in MHP [1], annex P. A small number of the 
MHP methods are not required in GEM terminal specifications. Additionally, in GEM these methods are bound to the 
more abstract signalling requirements of annex B. 

The description of each class from the org.dvb.dsmcc package defined in MHP [1], annex P is included in the present 
document, except as modified below. 

In all cases, references to a "DSMCC object" in the signalling is to be interpreted as referring to the entity in the 
signalling represented by an object of type DSMCCObject in the present document. 

P.2.1 DSMCCObject 

The first sentence of the class description should be interpreted as meaning that this class represents objects in a Service 
domain. 

P. 2.1.1 DSMCCObject.getSigners() 

GEM terminal specifications may be written such that some applications are trusted without being authenticated by the 
MHP mechanism. For these applications, a GEM terminal specification may be written such that it is a valid 
implementation option that this method returns an outer array of size zero when the DSMCCObject is loaded. 

P.2.1 .2 DSMCCObject.getSigners(boolean known_root) 

NOTE: The semantics of the DSMCCObject. getSigners(boolean known_root) method are unchanged and require 
processing. 

P.2.2 DSMCCStream 

References to BIOP::Stream message are to be interpreted as meaning the stream description as defined in clause B.3. 
References to the BIOP::StreamEvent message are to be interpreted as meaning the stream even description defined in 
clause B.4.1. References to elements of the BIOP messages are to be interpreted as referring to the corresponding 
element of the generic descriptions from annex B, as detailed below. 

P.2.2. 1 isAudio() method 

This shall return true if the audio_stream flag indicates that this stream contains audio. 

P. 2.2.2 isData() method 

This shall return true if the data_stream flag indicates that this stream contains data. 

P. 2.2.3 isMPEGProgram() method 

This shall return true if the is_mpeg_program flag indicates that this object represents an MPEG program. 

P. 2.2.4 isVideo() method 

This shall return true if the video_stream flag indicates that this stream contains video. 
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P.2.3 DSMCCStreamEvent 

References to the BIOP::StreamEvent message are to be interpreted as meaning the stream even description defined in 
clause B.4.1. References to elements of the BIOP messages are to be interpreted as referring to the corresponding 
element of the generic descriptions from annex B, as detailed below. 

Throughout this class, references to a DSMCC StreamEvent in the signalling are to be read as referring to a trigger 
object, as defined in clause B.4.1. 

P.2.4 InvalidFormatException 

This exception may be thrown when any inconsistency in the underlying signalling is received. 

P.2.5 ServiceDomain 

The first paragraph of the class description is to be replaced by the following: A ServiceDomain represents the entity 
described in clause B.l. 

Throughout this class, references to "service gateway" or "service domain" are to be interpreted as referring to service 
domain, as described in clause B.l. 

P.2.5. 1 ServiceDomain. attach (byte[]) 

ServiceDomain. attach(byte[]) is required by the present document. The syntax and usage of the NSAP address is out of 
the scope of the present document. 

P. 2. 5. 2 ServiceDomain. attach (Locator) and attach (Locator, int) 

The locator parameter is to be interpreted as any locator that refers to a service domain. Locator formats are discussed in 
clause 6.3.3. 

P. 2. 5. 3 ServiceDomain. getLocator() 

The description of this method is considered to read as follows: 

• Return the locator for this service domain. If this ServiceDomain instance was last attached by specifying a 
locator then that exact same locator shall be returned. If the attach was done with the attach(locator, int) 
signature, the locator is complemented with a representation of the integer. 

P. 2.5.4 ServiceDomain.getNSAPAddress() 

Signalling to support the ServiceDomain. getNSAPAddress() method is not required by the present document. In 
terminal specifications where no such signalling is defined, the behaviour of invoking this method may be undefined. 

P. 2. 5. 5 ServiceDomain. getURL(Locator) 

The description of this static method is considered to read as follows: 

Returns a URL corresponding to a locator referring to a file or a directory, as specified in table 7.1.3. If the service 
domain corresponding to the locator is attached and the file or directory referenced in the locator exists then an instance 
of java.net. URL is returned which can be used to reference this object. 

Parameters: 

1 - a locator referring to a file or directory, as specified in table 7.1.3. 
Returns: 

a java.net. URL which can be used to access the file or directory referenced by the locator. 
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Throws: 

InvalidLocatorException - if the locator is not a valid locator or does not includes all elements leading to a file or 
directory. 

NotLoadedException - is thrown if the locator is valid and includes enough information but it references a service 
domain which is not attached. 

FileNotFoundException - if the service domain is attached but the file or directory referenced by the locator does not 
exist. 

P.2.6 ServiceXFRErrorEvent 

This class is required by the present document, however signalling that would cause this error to be generated is not 
required by the present document. 

P.2.7 ServiceXFRException 

This class is required by the present document, however signalling that would cause this exception to be generated is 
not required by the present document. 

P.2.8 ServiceXFRReference 

This class is required by the present document, however signalling that would cause an event containing an object of 
this type is not required by the present document. 

P.2.9 StreamEvent 

Throughout this class, references to the DSMCC stream event descriptor are to be read as referring to the trigger event, 
as described in clause B.4.2. References to the event data refer to the payload defined in that clause. 
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Annex Q (normative): 
Datagram socket buffer control 

MHP [1], annex Q is included in the present document. 
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Annex R (normative): 

DVB-J return channel connection management API 

MHP [1], annex R is included in the present document. 
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Annex S (normative): 
Application listing and launching 

MHP [1], annex S is included in the present document. 
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Annex T (normative): 
Permissions 

MHP [1], annex T is included in the present document. 
NOTE: see clause 11.10, "Java Permissions". 
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Annex U (normative): 
Extended graphics APIs 

MHP [1], annex U is included in the present document. 
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Annex V: 
Void 
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Annex W (informative): 
DVB-J examples 

W.1 DVB-J examples from MHP 

MHP [1], annex W is included in the present document. 



W.2 Example of enumeration extension 

To illustrate the importance of the requirement in clause 4.1.4.1, consider an application that is written to the GEM 
specification which wishes to query the type of return channel connection, and react accordingly. Such code might be 
written in the following manner: 

import org . dvb . net . rc . RC I interface ; 
import org . dvb . net . rc . RCInterf aceManager ; 

public class AppRCTester { 

/** 

* Set up the return channel. 

* @return true if it was successfully set up, false otherwise. 
*/ 

public boolean setUpRCO { 

RCInterf ace [ ] ifs = RCInterf aceManager . get Instance (). get Interfaces () ; 
boolean success = false; 

for (int i = 0; [success && i < ifs. length; i++) { 
RCInterface inter = ifs[i]; 
switch ( inter . getType () ) { 
case TYPE_CATV: 

success = setupCATV (inter) ; 

break; 
case TYPE_DECT: 

success = setupDECT (inter) ; 

break; 
case TYPE_ISDN: 

success = setupISDN (inter) ; 

break; 
case TYPE_LMDS: 

success = setupLMDS (inter) ; 

break; 
case TYPE_MATV: 

success = setupMATV (inter) ; 

break; 
case TYPE_UNKNOWN: 
case TYPE_OTHER: 

success = setupOTHER (inter) ; 

break; 
default : 

// Do nothing - this always fails 

} 

return success; 

} 

.... definition of methods setupCATV et al. 

} 

If it were permissible for a GEM terminal specification to sub-divide TYPE_CATV by introducing new values into the 
enumeration, then this code would always fail. 
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If a terminal specification needs to sub-divide the values of an enumeration, it may do so by introducing a new method 
to report the sub-divisions. For example, to sub-divide TYPE_CATV, a terminal specification could introduce an 
interface and a set of values like the following: 

package org . specbody . net . rc; 
/ * * 

* On specbody terminals, all instances of org . dvb . net . rc . RCInterf ace 

* for which getTypeO returns TYPE_CATV shall implement this interface. 
V 

public interface CATVRCInterf ace { 

public final static int TYPE_CATV_SUBTYPE_1 = 1; 
public final static int TYPE_CATV_SUBTYPE_2 = 2; 
public final static int TYPE_CATV_SUBTYPE_3 = 3; 

/ -k -k 

* @returns one of TYPE_CATV_SUBTYPE_1 , TYPE_CATV_SUBTYPE_2 

* or TYPE_CATV_SUBTYPE_3 
V 

public int getCATVType ( ) ; 

} 

Note that this extension mechanism works for org . dvb . net . rc . RCInterf ace because instances of this class are 
always created by a factory method that is a part of the platform. This particular method for extending the behaviour of 
GEM would not work if the enumeration value were returned by a method in a class with a constructor that is accessible 
to applications, because it would be impossible to mandate that all instances conforming to certain criteria implement an 
additional interface. In this case, other extension mechanisms would need to be employed. 
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Annex X (normative): 
Test support 

MHP [1], annex X is included in the present document. 
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Annex Y (normative): 

Inter-application and Inter-Xlet communication API 

MHP [1], annex Y is included in the present document. 
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Annex Z (informative): 

Services, service contexts and applications in an MHP 
environment 

MHP [1], annex Z is included in the present document, with the following notes and modifications. 

This informative clause includes references to some signalling details not required by the present document. Where this 
is the case, it is to be read as an example of one possible way of fulfilling the abstract requirements placed on terminal 
signalling by the present document. 
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